Back to all FAQs

Why doesn’t my organization appear when I try to add it or link a project?

The organization is missing when Chromatic cannot read it through your connected GitHub account and the Chromatic OAuth App. Check these conditions:

You are not a member of the organization. The list includes only organizations you have joined on GitHub. An invitation does not count until you accept it. Check your status on the organization’s People page or review GitHub’s guides to organization membership and organization roles.

The organization has not approved the Chromatic OAuth App. An organization Owner must approve the app when GitHub restricts third-party OAuth access.

The organization enforces an IP allow list. Add Chromatic’s outbound IP addresses or GitHub will block the request. See how to allowlist Chromatic’s IP addresses.

OAuth App and GitHub App

• The Chromatic OAuth App signs you in and reads which organizations and repositories you can access. It supplies the organization list when you add an account.
• The Chromatic GitHub App (chromatic-com) handles pull request checks and UI Review after the account exists. Installing it does not add the organization to the account list.

Another GitHub organization member can add the account in Chromatic and invite you directly to its projects.

Why extra repositories appear after I restrict the GitHub App

GitHub OAuth App approval is organization-wide. GitHub does not offer a selected-repository setting for the Chromatic OAuth App. Chromatic lists repository metadata (name, slug, default branch) that the signed-in GitHub profile can already see. That list is how you add an account and link a project. It is not the same as chromatic-com repository access.

Installing chromatic-com on selected repositories does not hide other organization repositories from Chromatic’s picker. Pull request checks and UI Review follow the GitHub App install. Add and link still need organization OAuth approval. Revoking that OAuth approval removes the organization from those flows.

To limit pull request integration, keep organization OAuth approved and restrict chromatic-com to the repositories that need checks and UI Review.

If add or link fails with Could not retrieve repository ID, that is the opposite case: the GitHub App does not include that repository. See Could not retrieve repository ID when adding a project.

Request OAuth App approval

Request OAuth App approval if your GitHub organization is missing from Chromatic’s account list.

1. Sign in to Chromatic with GitHub to authorize the OAuth App for your personal GitHub account.
2. When adding an account in Chromatic, select Check permissions. This opens the Chromatic OAuth App settings in GitHub.
3. Next to the GitHub organization, select Request access, then Request approval from owners.
4. After an organization owner approves access, return to Chromatic and select refresh this list.

You can return to the OAuth App settings to review its organization access. See GitHub’s OAuth App approval instructions.

Request GitHub App approval

Request GitHub App installation for pull request checks and UI Review. This is separate from OAuth App approval.

1. Select Install Chromatic on GitHub when Chromatic prompts you to enable the integration, or open the Chromatic GitHub App installation page.
2. Select the GitHub organization and repositories. If you cannot install the app yourself, submit an installation request to the organization owner.
3. Ask the organization owner to review the request GitHub sends by email. After installation, the owner can review the installed app and its repository access in the organization’s Settings » GitHub Apps.

For a pending request, check with the organization owner. GitHub documents how installation requests reach organization owners.

If the organization has disabled app access requests, contact a GitHub organization owner directly.

Could not retrieve repository ID when adding a project

This error means Chromatic cannot see the repository through the Chromatic GitHub App (chromatic-com). It is not an OAuth listing problem. If extra organization repositories appear in the picker, see why extra repositories appear after I restrict the GitHub App.

When chromatic-com is installed on selected repositories, add and link can fail for any repository that is not on that list. Check both of these:

1. Connect GitHub on your Chromatic profile. On an SSO account, open {subdomain}.chromatic.com/profile.
2. Ask a GitHub organization owner to grant chromatic-com access to that repository: organization Settings → GitHub Apps → Chromatic → Repository access. See Request GitHub App approval.

After both are in place, try adding or linking the project again.