If you manage a Shopify store and use Git for version control, you have probably felt the friction of updating your theme. You push code to GitHub, GitLab, or Bitbucket, but your Shopify theme does not update automatically. Instead, you are stuck downloading files, logging into the Shopify admin, and uploading them by hand — a process that is slow, error-prone, and scales poorly as your team grows.
DeployHQ bridges that gap. It connects your Git repository directly to your Shopify store and deploys only the files that changed, automatically, every time you push. No manual uploads, no missed files, no broken themes in production.
This guide walks through the full setup: connecting your repository, configuring your Shopify theme as a deployment target, running your first deployment, and enabling automatic deployments so future changes go live the moment you push.
Prerequisites
Before you start, make sure you have:
- A Shopify store with theme access (store owner or staff with Themes permission)
- Your theme code in a Git repository hosted on GitHub, GitLab, or Bitbucket
- A DeployHQ account — the free plan includes 1 project with up to 10 deployments per day
If you are new to Git, the official Git documentation is an excellent starting point. We also have a library of Git tutorials covering everything from basics to advanced workflows.
Creating a new project in DeployHQ
Once you have signed into DeployHQ, click the New Project button at the top of the screen.
Enter a name for your project (something like My Shopify Theme
) and choose where your repository is hosted. DeployHQ integrates natively with GitHub, GitLab, and Bitbucket. If you host your repository elsewhere, you can configure it manually using any Git URL.
Connecting to your repository
After clicking Create Project, you will be prompted to authenticate with your repository host. Select your account and you will see a list of repositories you have access to.
Select the repository that contains your Shopify theme code. DeployHQ will automatically add an SSH key to access it. Keep the Add a webhook option checked — this is what enables automatic deployments later.
Configuring your Shopify theme
Once your repository is connected, DeployHQ takes you to the New Server screen. Enter a name for your server (for example, Production Theme
), then choose Shopify as the protocol.
Enter your store URL in the format mystore.myshopify.com and specify a theme name. Click Create Server and you will be redirected to Shopify to approve DeployHQ's access to your store.
Once approved, your project is fully configured and ready for its first deployment.
Running your first deployment
With the repository and server connected, click Deploy for the first time in the top right of your project.
Review the deployment details — your server and branch are pre-selected, and the start revision shows The very first commit since no previous deployments exist. The end revision defaults to the latest commit on your branch.
Click the green Deploy button. DeployHQ will transfer all your theme files to Shopify.
Once finished, the deployment log shows every file that was transferred. From this point on, DeployHQ tracks which commits have been deployed, so future deployments only upload the files that actually changed.
Enabling automatic deployments
Manual deployments work, but the real power is in automation. Navigate to Automatic Deployments in the left sidebar and enable the toggle next to your server.
Now, every time you push to your repository, DeployHQ automatically starts a deployment. Only the changed files are uploaded — no full re-uploads, no wasted time.
After pushing a test commit, the deployment starts on its own and the log confirms which files were updated:
You can verify the changes in your Shopify admin by navigating to the theme code editor:
That is it. Your Shopify theme now updates automatically every time you push to Git. No more manual uploads, no more missed files.
Using Build Pipelines to compile assets before deployment
Most modern Shopify themes use preprocessors and bundlers — Sass for stylesheets, TypeScript or ES modules for JavaScript, and tools like Webpack or Vite for bundling. Shopify does not run these build steps for you, and committing compiled assets into Git leads to merge conflicts and bloated diffs.
DeployHQ's Build Pipelines solve this. You define a series of build commands that run in an isolated environment (with Node, Ruby, PHP, and Python pre-installed) before files are deployed to Shopify. The compiled output is what gets uploaded — your repository stays clean.
A typical Shopify theme build pipeline might look like:
npm install
npm run build
DeployHQ runs these commands, then uploads the resulting compiled assets to your Shopify theme. Check out our deployment guides for framework-specific build pipeline configurations.
Provider-specific guides
If you want a step-by-step walkthrough tailored to your specific Git provider, we have dedicated guides:
- Deploy a Shopify theme from GitHub
- Deploy a Shopify theme from Bitbucket
- Secure and scalable Shopify theme updates
Get started
Ready to automate your Shopify deployments? Sign up for DeployHQ — the free plan is enough to get started with one project. For teams managing multiple stores or themes, check out our pricing plans for higher deployment limits and additional features.
If you have any questions, reach out to us at support@deployhq.com or on Twitter/X.