Adding Github accounts

Use this guide to connect one or more GitHub accounts to browse repositories and embed files.

Before you start

• You’ll need a GitHub account (work or personal) with access to the repositories you want to use.

• If your organization enforces SSO or app approvals, an org owner may need to approve the app before members can connect. If prompted by GitHub, complete any SSO steps.

Connect your first GitHub account

1. Open the Git browser from the Capable app (e.g., while inserting or configuring Git content with /git from the editor.

2. Select Connect when prompted.

3. Sign in to GitHub and consent to the requested permissions.

4. After success, your repositories will begin to appear. Use search and filters to find the repo you need.

Add another GitHub account (work and personal)

You can connect multiple GitHub accounts and switch between them:

1. Open the Git browser.

2. Open the account selector and choose Add account.

3. Sign in to GitHub with the additional account and complete the consent flow.

4. Use the account selector to switch which account is active when browsing repos and files.

Switching accounts

• Use the account dropdown in the Git browser to pick the account you want to use.

• The active account determines which repositories you see and which files you can access.

Organization approval and SSO

• If your GitHub organization requires approval or SSO, an org owner may need to approve the app and you may be asked to re‑authenticate with SSO.

• If you don’t see expected org repositories, ask your org owner to approve the app, then try connecting again.

What other users see

• Access is always evaluated per user. If you add a file from a private repository, other viewers will only see it if they also have access via their own GitHub account.

• Viewers who are not connected or do not have permissions may be prompted to connect or will see an access error in place of the content.

Disconnecting an account

• To remove access, use GitHub’s account settings (Authorized OAuth Apps) or your organization’s connected apps settings to revoke the app’s access. After revocation, reconnect if you need access again.

Troubleshooting

• I connected the wrong account: Open the Git browser, add the correct account, and select it in the account dropdown.

• My org repos don’t appear: Request organization approval from an org owner and reconnect, completing any SSO prompts.

• I can’t open a file I can see on GitHub: Ensure you’ve selected the account with access to that specific repository and branch.

Privacy and security

• Connections are per user. Your credentials are not shared with other users of the app.

• The app only requests the permissions necessary to browse and render content you already have access to.