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.

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.