Link Your GitHub To Shopify Theme — Guide

3 min readJul 18, 2022

Shopify GitHub integration allows us to make and track changes to theme files via Git. This article today explains how we can link our Shopify theme to a Github repository, connect a branch as a theme, test the connection, and then publish the theme.

#Connect to GitHub Account/Organization

To get started with GitHub — Shopify integration, we need to connect a GitHub account to Shopify.

From your Shopify admin, on the left sidebar click on Online Store, then Themes.
Scroll to Theme library section, and click Add theme then Connect from GitHub.

From the Connect theme pane, click Log in to GitHub.

Enter your GitHub credentials, then Authorize Shopify

Select the Account/Organization you want to connect to your Shopify theme and click Next:

Next, choose whether you want to install the app for all repositories, or choose the repository from the list given. (I recommend selecting only the repository you need).
Click Install — After Installing Shopify GitHub App you’ll be redirected back to Shopify.

#Connect branch

From your Shopify admin, on the left sidebar click on Online Store, then Themes.
Scroll to the Theme library section, and click Add theme then Connect from GitHub.
On the same Connect theme pane, select the target repository.

Click Connect next to the branch that you want to connect.

The theme appears in your Theme Library. Themes that are connected to GitHub list the repository, branch name, and last commit time on the theme card.

# Test Connection

To ensure that the connection between your branch and repository is working, you can make a small change to the theme and then verify that a commit was made in the branch.

After the connection is made, all commits to the branch that we’ve selected are pulled into the theme, and all changes that you make through the Shopify admin are pushed to the branch.

#Publish the theme

Now all you need to do is to publish the theme to see all changes going on the live site.

#Useful resources

Guide | How to Become a Shopify Themes Developer 2022 — Roadmap

Guide | To Become a Shopify Theme Developer

medium.com

Version control for Shopify themes

When you build a Shopify theme, you can introduce optional version control to track and manage changes to your theme…

shopify.dev

Github Integration: "Branch isn't a valid theme"

Getting this error for a theme that I know is perfectly valid because I can upload it just fine as a zip or using the…

community.shopify.com

So, this is the end of our article today, I hope you learned something from it.
Have a wonderful great day. Don’t hesitate to contact me if you have any questions.