The Shopify GitHub App
Shopify offers a GitHub app to connect your Shopify and GitHub accounts. Use it when developing themes and Hydrogen storefronts.
Connect Shopify and GitHub
Anchor link to section titled "Connect Shopify and GitHub"Install the Shopify GitHub app to connect your accounts.
Your Shopify account can only be connected to one GitHub account, which is why we recommend using organization accounts, which enable more flexible access control.
Organization accounts
Anchor link to section titled "Organization accounts"We recommend using GitHub organizations if possible. Organizations work with multiple individual GitHub accounts, enabling easier collaboration for teams, and more secure access control for GitHub repositories and Shopify stores.
Organization accounts are particularly helpful if you need to transfer repository ownership, which is common for agencies and freelance developers.
Personal accounts
Anchor link to section titled "Personal accounts"You can connect your personal GitHub account to Shopify, but you can only have one Shopify account connected to one personal GitHub account at a time. That's why we recommend using organization accounts if possible.
You can convert a personal GitHub account to an organization.
Required GitHub permissions
Anchor link to section titled "Required GitHub permissions"For security reasons, we recommend granting access permission on a per-repository basis, instead of granting them for all repositories in your account or organization.
Read and write access | Read access |
---|---|
|
|
Disconnect Shopify and GitHub
Anchor link to section titled "Disconnect Shopify and GitHub"You can disconnect your Shopify and GitHub accounts in your GitHub settings:
- Open your GitHub settings for app authorizations
- Beside the Shopify app, click Revoke.
Check the GitHub docs for more details on deleting GitHub apps.
Troubleshooting and known limitations
Anchor link to section titled "Troubleshooting and known limitations"- If you're connecting a new development store, then you can't set up the GitHub app on the initial login after the store is created. Log out of your development store and log in again through the Partner Dashboard before proceeding.
- If you access GitHub with SAML/SSO, you need an active SAML session to use the Shopify GitHub app. You can create a new SAML session by going to
https://github.com/orgs/{YOUR_ORGANIZATION}/sso
. - If your GitHub organization enables SAML/SSO and you already had the Shopify GitHub app installed, then you'll need to re-authorize all your GitHub apps, including the Shopify app.
- The Shopify GitHub app doesn't support the IP allow list feature of GitHub Enterprise Cloud.
- If you convert your user account to an organization, then you'll need to uninstall and reinstall the Shopify GitHub app.
- When connecting a repository, if you don't see the one you want to connect in the list of available repositories, then the GitHub organization owner will need to update the repository access settings for the Shopify GitHub app.