Enable or disable G Suite integration

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

To enable G Suite integration, you'll need to organize two things: administrator permissions, and Atlassian account.


Before integrating with G Suite, make sure you've:

  • Allowed access to the Google Administrative APIs for your domain. Ensure this setting is enabled on your domain before integrating G Suite.
  • Obtained administrator access on your G Suite domain to set up the integration. 
    Note: If your administrator access is revoked in the future, your integration will stop functioning.
  • Become a site admin in Atlassian Cloud. 
    Note: Once the connection is established, you won't have to keep your admin permission in Atlassian Cloud to maintain the connection.

Check out the G Suite FAQs for additional permissions that may be required to set up group-based syncing. 

How to connect G Suite to your Atlassian Cloud site

  1. Go to  Site administration
  2. Select G Suite in the sidebar.
  3. Select Connect G Suite.
  4. Follow the prompts to select which groups you want to sync from G Suite. When you're done, your screen should look like this:

    You can connect multiple Atlassian Cloud sites to the same G Suite account - if you do, ownership of the domain and users from the domain would be shared across instances. 

Domain management

When you connect your Atlassian site to G Suite, the following will apply:

  • All domains and sub-domains associated with your G Suite account will be automatically claimed on your behalf.
  • All domains you've previously claimed will be revoked. 
  • As long as you remain connected to G Suite, you won't be able to manually claim any domains via Atlassian administration.
  • Note that if you have users who belong to a claimed domain, but aren't part of the groups you've synced, you can't edit their details anywhere. If you'd like to update a user's details, they'll need to be synced.

To learn more, check out our page on Domain verification

Password policies

When you connect your Atlassian Cloud site to G Suite, your existing password policy will be revoked. You can set a password policy for your Google-managed users in G Suite. Any users not belonging to your Google domains will have a default password policy set by Atlassian. Check out How G Suite users log in for more information.

How to set default application access

After you enable G Suite, you can set up which products new Google users have access to, and which groups they're placed in when the users are initially created. See Manage application access for full details.

How to disconnect G Suite from your Atlassian Cloud site

When you disconnect your G Suite integration:

  • Your users will still be able to log in to your Atlassian Cloud site with their Google credentials. However, their details won't be synced.
  • If your domain hasn't been claimed by an Atlassian Cloud instance, then users with accounts from that domain will no longer be managed and will be able to edit their account details.

  1. Go to  Site administration.
  2. Select G Suite in the sidebar.
  3. Select Disconnect G Suite and follow the prompts.

Last modified on Apr 26, 2018

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.