diff --git a/docs/documentation/platform/github-org-sync.mdx b/docs/documentation/platform/github-org-sync.mdx
index 519e12db8..aa7ee3550 100644
--- a/docs/documentation/platform/github-org-sync.mdx
+++ b/docs/documentation/platform/github-org-sync.mdx
@@ -45,6 +45,22 @@ Once configured, the GitHub Organization Synchronization feature functions as fo
 
 When a user logs in via the GitHub OAuth flow and selects the configured organization, the system will then automatically synchronize the teams they are a part of in GitHub with corresponding groups in Infisical.
 
+## Manual Team Sync
+
+You can manually synchronize GitHub teams for all organization members who have previously logged in with GitHub. This bulk sync operation updates team memberships without requiring users to log in again.
+
+To trigger a manual sync, click the **Manually sync GitHub teams for all organization members** button:
+
+![Manual sync](../../images/platform/external-syncs/github-org-sync-manual-sync.png)
+
+If you don't have a GitHub token configured or your token has expired, a modal will appear prompting you to provide one:
+
+![token](../../images/platform/external-syncs/github-org-sync-manual-sync-token.png)
+
+<Info>
+  The token must be granted **read:org** and **read:user** permissions to successfully sync groups. This configuration is only required once - if you already have a valid token configured, the sync will proceed automatically.
+</Info>
+
 ## Troubleshooting
 
 <Accordion title="Please check if your organization has approved the Infisical OAuth application.">
diff --git a/docs/images/platform/external-syncs/github-org-sync-manual-sync-token.png b/docs/images/platform/external-syncs/github-org-sync-manual-sync-token.png
new file mode 100644
index 000000000..5f81232cf
Binary files /dev/null and b/docs/images/platform/external-syncs/github-org-sync-manual-sync-token.png differ
diff --git a/docs/images/platform/external-syncs/github-org-sync-manual-sync.png b/docs/images/platform/external-syncs/github-org-sync-manual-sync.png
new file mode 100644
index 000000000..3ff168629
Binary files /dev/null and b/docs/images/platform/external-syncs/github-org-sync-manual-sync.png differ
diff --git a/frontend/src/pages/organization/SettingsPage/components/OrgProvisioningTab/OrgGithubSyncSection.tsx b/frontend/src/pages/organization/SettingsPage/components/OrgProvisioningTab/OrgGithubSyncSection.tsx
index da5dcb8d2..74e160794 100644
--- a/frontend/src/pages/organization/SettingsPage/components/OrgProvisioningTab/OrgGithubSyncSection.tsx
+++ b/frontend/src/pages/organization/SettingsPage/components/OrgProvisioningTab/OrgGithubSyncSection.tsx
@@ -310,7 +310,11 @@ export const OrgGithubSyncSection = () => {
           subTitle="Provide a GitHub access token with organization and team access permissions"
         >
           <div className="space-y-4">
-            <FormControl label="GitHub Access Token">
+            <FormControl
+              label="GitHub Access Token"
+              tooltipText="The provided token must be granted read:org and read:user permissions in order to successfully sync groups"
+              tooltipClassName="max-w-md"
+            >
               <div className="relative">
                 <Input
                   type="password"
@@ -335,11 +339,6 @@ export const OrgGithubSyncSection = () => {
                 )}
               </div>
             </FormControl>
-            <p className="text-sm text-mineshaft-400">
-              The token needs <code>read:org</code> and <code>read:user</code> permissions to access
-              organization teams and members. Once provided and verified, the token will be securely
-              stored for future syncs.
-            </p>
             <div className="flex justify-between">
               <Button
                 colorSchema="secondary"