{"slug":"user-group-provisioning-for-google-workspace","title":"User & group provisioning for Google Workspace","tags":["tailscale"],"agent_summary":"Last validated: Jan 5, 2026","trigger_phrases":[],"runnable":false,"markdown":"\r\n# User & group provisioning for Google Workspace\r\n\r\nLast validated: Jan 5, 2026\r\n\r\nThis featureis available for [the Standard, Premium, and Enterprise plans](https://tailscale.com/pricing).\r\n\r\nTailscale's use and transfer of information received from Google APIs to any other app will adhere to [Google API Services User Data Policy](https://developers.google.com/terms/api-services-user-data-policy#additional_requirements_for_specific_api_scopes) including the Limited Use requirements.\r\n\r\nTailscale supports synchronizing Google Workspace users and groups for use in Tailscale [access controls](https://tailscale.com/docs/features/access-control).\r\n\r\n- With group sync, you can refer to a group from Google in your [tailnet policy file](https://tailscale.com/docs/reference/glossary#tailnet-policy-file), with a human-readable name.\r\n- With user sync, you can onboard and offboard users to Tailscale. For related information, refer to [Offboarding when using user & group provisioning](https://tailscale.com/docs/features/sharing/how-to/offboard#offboarding-when-using-user--group-provisioning-scim).\r\n\r\n## [Prerequisites](https://tailscale.com/docs/integrations/google-sync\\#prerequisites)\r\n\r\n- You need a Google Workspace account.\r\n- You need a Tailscale network (known as a tailnet).\r\n- Your tailnet's identity provider needs to be Google.\r\n\r\n## [Set up Google User & Group sync](https://tailscale.com/docs/integrations/google-sync\\#set-up-google-user--group-sync)\r\n\r\nYou need to be an [Owner, Admin, or IT admin](https://tailscale.com/docs/reference/user-roles) in Tailscale to complete these steps.\r\n\r\n1. Open the Tailscale [User management](https://login.tailscale.com/admin/settings/user-management) page.\r\n2. In the **Google Sync** section, select **Enable**.\r\n3. In the authorization page that opens, select **Authorize with Google**.\r\n4. In the **Choose an account** page, select your Google Workspace super user account.\r\n5. In the **Sign in** page, select **Continue**.\r\n6. When prompted to allow access to your tailnet, select **Allow**.\r\n\r\nWhen you enable Google Sync for the very first time, no users or groups will be added unless you specify\r\ngroups explicitly or select the **Sync all users** option.\r\n\r\n## [Sync all users](https://tailscale.com/docs/integrations/google-sync\\#sync-all-users)\r\n\r\nBy default, Google Sync only adds users from groups you selected. But if you'd like to mirror all of your Google Workspace users, then you can enable the **Sync all users** option which will immediately start provisioning users to your tailnet.\r\n\r\nWhen **Sync all users** is not enabled, users will be suspended if they are removed from all synced groups. If this is not the desired behavior, enable **Sync all users** or create an additional Google group that includes all the users to sync. For example, you may have a synced group named `all-tailscale-users` that contains all users that should have Tailscale access, and then use other groups to manage access control.\r\n\r\n## [Manage groups](https://tailscale.com/docs/integrations/google-sync\\#manage-groups)\r\n\r\nBy default, a group and its members does not sync into your tailnet unless you explicitly select it.\r\n\r\nYou need to be an [Owner, Admin, or IT admin](https://tailscale.com/docs/reference/user-roles) in Tailscale to complete these steps.\r\n\r\n1. Open the Tailscale [User management](https://login.tailscale.com/admin/settings/user-management) page of the admin console.\r\n2. In the **Google Sync** section, select the ![ellipsis icon](https://tailscale.com/files/images/icons/fa-ellipsis-h.svg) menu and then select **Manage groups**.\r\n\r\nIf a group is renamed in Google Admin Console, the reference does not rename. You will always use the group email to reference the group in your Tailscale access control policies.\r\n\r\n## [Unsync unassigned users](https://tailscale.com/docs/integrations/google-sync\\#unsync-unassigned-users)\r\n\r\nAfter adding groups and their members to your tailnet, if you want to remove the users whom you previously added using the **Sync all users** option who are not part of the groups you added, you can use the option **Unsync unassigned users**.\r\n\r\nYou need to be an [Owner, Admin, or IT admin](https://tailscale.com/docs/reference/user-roles) in Tailscale to complete these steps.\r\n\r\n1. Open the Tailscale [User management](https://login.tailscale.com/admin/settings/user-management) page of the admin console.\r\n2. In the **Google Sync** section, select the ![ellipsis icon](https://tailscale.com/files/images/icons/fa-ellipsis-h.svg) menu and then select **Unsync unassigned users**.\r\n\r\n## [Force a sync](https://tailscale.com/docs/integrations/google-sync\\#force-a-sync)\r\n\r\nChanges to group membership and users within the Google Admin Console are synced to Tailscale every 40 minutes. You can also force a sync to Tailscale.\r\n\r\nYou need to be an [Owner, Admin, or IT admin](https://tailscale.com/docs/reference/user-roles) in Tailscale to complete these steps.\r\n\r\n1. Open the Tailscale [User management](https://login.tailscale.com/admin/settings/user-management) page of the admin console.\r\n2. In the **Google Sync** section, select the ![ellipsis icon](https://tailscale.com/files/images/icons/fa-ellipsis-h.svg) menu and then select **Force sync**.\r\n\r\n## [Use groups in your tailnet policy file](https://tailscale.com/docs/integrations/google-sync\\#use-groups-in-your-tailnet-policy-file)\r\n\r\nYou can refer to a group from Google Workspace in your [tailnet policy file](https://tailscale.com/docs/reference/glossary#tailnet-policy-file) file, with a human-readable name. For example:\r\n\r\n```json\r\n{\r\n  \"grants\": [\\\r\n    {\\\r\n      \"src\": [\"group:admins@example.com\"],\\\r\n      \"dst\": [\"*\"],\\\r\n      \"ip\": [\"*\"]\\\r\n    },\\\r\n    {\\\r\n      \"src\": [\"group:employees@example.com\"],\\\r\n      \"dst\": [\"autogroup:self\"],\\\r\n      \"ip\": [\"*\"]\\\r\n    },\\\r\n    {\\\r\n      \"src\": [\"group:engineering@example.com\"],\\\r\n      \"dst\": [\"tag:logging\"],\\\r\n      \"ip\": [\"*\"]\\\r\n    }\\\r\n  ]\r\n}\r\n```\r\n\r\nYou can use the [visual policy editor](https://tailscale.com/docs/features/visual-editor) to manage your tailnet policy file. Refer to the [visual editor reference](https://tailscale.com/docs/reference/visual-editor) for guidance on using the visual editor.\r\n\r\nGroups synced from Google Workspace do not replace [groups](https://tailscale.com/docs/reference/syntax/policy-file#groups) in Tailscale. You can use Google Workspace group sync and also define groups in the tailnet policy file.\r\n\r\n## [Disable Google User & Group sync](https://tailscale.com/docs/integrations/google-sync\\#disable-google-user--group-sync)\r\n\r\nYou need to be an [Owner, Admin, or IT admin](https://tailscale.com/docs/reference/user-roles) in Tailscale to complete these steps.\r\n\r\n1. Open the Tailscale [User management](https://login.tailscale.com/admin/settings/user-management) page of the admin console.\r\n2. In the **Google Sync** section, select the ![ellipsis icon](https://tailscale.com/files/images/icons/fa-ellipsis-h.svg) menu and then select **Disable**.\r\n3. Follow the prompts to confirm and disable Google User & Group sync.\r\n\r\n## [Limitations](https://tailscale.com/docs/integrations/google-sync\\#limitations)\r\n\r\n- The maximum number of groups that can be synced is 100.\r\n- After a new group is created in Google Workspace, a Tailscale [Owner, Admin, or IT admin](https://tailscale.com/docs/reference/user-roles) must open the [Google Group Sync](https://login.tailscale.com/admin/settings/user-management) page and select the group to allow syncing of the group.\r\n- Users that do not share the same domain as the tailnet's domain are skipped.\r\n- Google-synced groups don't work with [Mullvad exit node](https://tailscale.com/docs/features/exit-nodes/mullvad-exit-nodes) access control policies.\r\n\r\n![Project Logo](https://cdn.brandfetch.io/tailscale.com/fallback/lettermark/theme/dark/h/256/w/256/icon?c=1bfwsmEH20zzEfSNTed)\r\n\r\nAsk AI\r\n\r\nreCAPTCHA\r\n\r\nRecaptcha requires verification.\r\n\r\nprotected by **reCAPTCHA**\r\n","html":"<h1>User &#x26; group provisioning for Google Workspace</h1>\n<p>Last validated: Jan 5, 2026</p>\n<p>This featureis available for <a href=\"https://tailscale.com/pricing\">the Standard, Premium, and Enterprise plans</a>.</p>\n<p>Tailscale's use and transfer of information received from Google APIs to any other app will adhere to <a href=\"https://developers.google.com/terms/api-services-user-data-policy#additional_requirements_for_specific_api_scopes\">Google API Services User Data Policy</a> including the Limited Use requirements.</p>\n<p>Tailscale supports synchronizing Google Workspace users and groups for use in Tailscale <a href=\"https://tailscale.com/docs/features/access-control\">access controls</a>.</p>\n<ul>\n<li>With group sync, you can refer to a group from Google in your <a href=\"https://tailscale.com/docs/reference/glossary#tailnet-policy-file\">tailnet policy file</a>, with a human-readable name.</li>\n<li>With user sync, you can onboard and offboard users to Tailscale. For related information, refer to <a href=\"https://tailscale.com/docs/features/sharing/how-to/offboard#offboarding-when-using-user--group-provisioning-scim\">Offboarding when using user &#x26; group provisioning</a>.</li>\n</ul>\n<h2><a href=\"https://tailscale.com/docs/integrations/google-sync#prerequisites\">Prerequisites</a></h2>\n<ul>\n<li>You need a Google Workspace account.</li>\n<li>You need a Tailscale network (known as a tailnet).</li>\n<li>Your tailnet's identity provider needs to be Google.</li>\n</ul>\n<h2><a href=\"https://tailscale.com/docs/integrations/google-sync#set-up-google-user--group-sync\">Set up Google User &#x26; Group sync</a></h2>\n<p>You need to be an <a href=\"https://tailscale.com/docs/reference/user-roles\">Owner, Admin, or IT admin</a> in Tailscale to complete these steps.</p>\n<ol>\n<li>Open the Tailscale <a href=\"https://login.tailscale.com/admin/settings/user-management\">User management</a> page.</li>\n<li>In the <strong>Google Sync</strong> section, select <strong>Enable</strong>.</li>\n<li>In the authorization page that opens, select <strong>Authorize with Google</strong>.</li>\n<li>In the <strong>Choose an account</strong> page, select your Google Workspace super user account.</li>\n<li>In the <strong>Sign in</strong> page, select <strong>Continue</strong>.</li>\n<li>When prompted to allow access to your tailnet, select <strong>Allow</strong>.</li>\n</ol>\n<p>When you enable Google Sync for the very first time, no users or groups will be added unless you specify\r\ngroups explicitly or select the <strong>Sync all users</strong> option.</p>\n<h2><a href=\"https://tailscale.com/docs/integrations/google-sync#sync-all-users\">Sync all users</a></h2>\n<p>By default, Google Sync only adds users from groups you selected. But if you'd like to mirror all of your Google Workspace users, then you can enable the <strong>Sync all users</strong> option which will immediately start provisioning users to your tailnet.</p>\n<p>When <strong>Sync all users</strong> is not enabled, users will be suspended if they are removed from all synced groups. If this is not the desired behavior, enable <strong>Sync all users</strong> or create an additional Google group that includes all the users to sync. For example, you may have a synced group named <code>all-tailscale-users</code> that contains all users that should have Tailscale access, and then use other groups to manage access control.</p>\n<h2><a href=\"https://tailscale.com/docs/integrations/google-sync#manage-groups\">Manage groups</a></h2>\n<p>By default, a group and its members does not sync into your tailnet unless you explicitly select it.</p>\n<p>You need to be an <a href=\"https://tailscale.com/docs/reference/user-roles\">Owner, Admin, or IT admin</a> in Tailscale to complete these steps.</p>\n<ol>\n<li>Open the Tailscale <a href=\"https://login.tailscale.com/admin/settings/user-management\">User management</a> page of the admin console.</li>\n<li>In the <strong>Google Sync</strong> section, select the <img src=\"https://tailscale.com/files/images/icons/fa-ellipsis-h.svg\" alt=\"ellipsis icon\"> menu and then select <strong>Manage groups</strong>.</li>\n</ol>\n<p>If a group is renamed in Google Admin Console, the reference does not rename. You will always use the group email to reference the group in your Tailscale access control policies.</p>\n<h2><a href=\"https://tailscale.com/docs/integrations/google-sync#unsync-unassigned-users\">Unsync unassigned users</a></h2>\n<p>After adding groups and their members to your tailnet, if you want to remove the users whom you previously added using the <strong>Sync all users</strong> option who are not part of the groups you added, you can use the option <strong>Unsync unassigned users</strong>.</p>\n<p>You need to be an <a href=\"https://tailscale.com/docs/reference/user-roles\">Owner, Admin, or IT admin</a> in Tailscale to complete these steps.</p>\n<ol>\n<li>Open the Tailscale <a href=\"https://login.tailscale.com/admin/settings/user-management\">User management</a> page of the admin console.</li>\n<li>In the <strong>Google Sync</strong> section, select the <img src=\"https://tailscale.com/files/images/icons/fa-ellipsis-h.svg\" alt=\"ellipsis icon\"> menu and then select <strong>Unsync unassigned users</strong>.</li>\n</ol>\n<h2><a href=\"https://tailscale.com/docs/integrations/google-sync#force-a-sync\">Force a sync</a></h2>\n<p>Changes to group membership and users within the Google Admin Console are synced to Tailscale every 40 minutes. You can also force a sync to Tailscale.</p>\n<p>You need to be an <a href=\"https://tailscale.com/docs/reference/user-roles\">Owner, Admin, or IT admin</a> in Tailscale to complete these steps.</p>\n<ol>\n<li>Open the Tailscale <a href=\"https://login.tailscale.com/admin/settings/user-management\">User management</a> page of the admin console.</li>\n<li>In the <strong>Google Sync</strong> section, select the <img src=\"https://tailscale.com/files/images/icons/fa-ellipsis-h.svg\" alt=\"ellipsis icon\"> menu and then select <strong>Force sync</strong>.</li>\n</ol>\n<h2><a href=\"https://tailscale.com/docs/integrations/google-sync#use-groups-in-your-tailnet-policy-file\">Use groups in your tailnet policy file</a></h2>\n<p>You can refer to a group from Google Workspace in your <a href=\"https://tailscale.com/docs/reference/glossary#tailnet-policy-file\">tailnet policy file</a> file, with a human-readable name. For example:</p>\n<pre><code class=\"language-json\">{\r\n  \"grants\": [\\\r\n    {\\\r\n      \"src\": [\"group:admins@example.com\"],\\\r\n      \"dst\": [\"*\"],\\\r\n      \"ip\": [\"*\"]\\\r\n    },\\\r\n    {\\\r\n      \"src\": [\"group:employees@example.com\"],\\\r\n      \"dst\": [\"autogroup:self\"],\\\r\n      \"ip\": [\"*\"]\\\r\n    },\\\r\n    {\\\r\n      \"src\": [\"group:engineering@example.com\"],\\\r\n      \"dst\": [\"tag:logging\"],\\\r\n      \"ip\": [\"*\"]\\\r\n    }\\\r\n  ]\r\n}\n</code></pre>\n<p>You can use the <a href=\"https://tailscale.com/docs/features/visual-editor\">visual policy editor</a> to manage your tailnet policy file. Refer to the <a href=\"https://tailscale.com/docs/reference/visual-editor\">visual editor reference</a> for guidance on using the visual editor.</p>\n<p>Groups synced from Google Workspace do not replace <a href=\"https://tailscale.com/docs/reference/syntax/policy-file#groups\">groups</a> in Tailscale. You can use Google Workspace group sync and also define groups in the tailnet policy file.</p>\n<h2><a href=\"https://tailscale.com/docs/integrations/google-sync#disable-google-user--group-sync\">Disable Google User &#x26; Group sync</a></h2>\n<p>You need to be an <a href=\"https://tailscale.com/docs/reference/user-roles\">Owner, Admin, or IT admin</a> in Tailscale to complete these steps.</p>\n<ol>\n<li>Open the Tailscale <a href=\"https://login.tailscale.com/admin/settings/user-management\">User management</a> page of the admin console.</li>\n<li>In the <strong>Google Sync</strong> section, select the <img src=\"https://tailscale.com/files/images/icons/fa-ellipsis-h.svg\" alt=\"ellipsis icon\"> menu and then select <strong>Disable</strong>.</li>\n<li>Follow the prompts to confirm and disable Google User &#x26; Group sync.</li>\n</ol>\n<h2><a href=\"https://tailscale.com/docs/integrations/google-sync#limitations\">Limitations</a></h2>\n<ul>\n<li>The maximum number of groups that can be synced is 100.</li>\n<li>After a new group is created in Google Workspace, a Tailscale <a href=\"https://tailscale.com/docs/reference/user-roles\">Owner, Admin, or IT admin</a> must open the <a href=\"https://login.tailscale.com/admin/settings/user-management\">Google Group Sync</a> page and select the group to allow syncing of the group.</li>\n<li>Users that do not share the same domain as the tailnet's domain are skipped.</li>\n<li>Google-synced groups don't work with <a href=\"https://tailscale.com/docs/features/exit-nodes/mullvad-exit-nodes\">Mullvad exit node</a> access control policies.</li>\n</ul>\n<p><img src=\"https://cdn.brandfetch.io/tailscale.com/fallback/lettermark/theme/dark/h/256/w/256/icon?c=1bfwsmEH20zzEfSNTed\" alt=\"Project Logo\"></p>\n<p>Ask AI</p>\n<p>reCAPTCHA</p>\n<p>Recaptcha requires verification.</p>\n<p>protected by <strong>reCAPTCHA</strong></p>\n"}