Branch & Theme Mapping
Theme Deploy maintains a simple mapping: one GitHub branch → one Shopify theme.
The default mapping
Out of the box:
- Your repository's default branch (usually
main) is your production branch. With auto-publish enabled, pushes to it deploy to your live theme. - Every other branch deploys to its own
[TD] {branch}preview theme.
Custom configuration (Team plan)
On the Team plan, the Settings page unlocks finer control:
Production branch
Choose any branch as your production branch instead of the repository default. Useful if you deploy from a production or release branch rather than main.
Preview branch rules
Control which branches get preview deployments:
| Option | Behavior |
|---|---|
| All branches | Every push to any branch triggers a preview deployment (default). |
| Selected branches | Only the production branch and the branches you list are deployed. |
| None | Only the production branch is deployed; other pushes are ignored. |
On non-Team plans, all branch pushes trigger deployments.
Renames and edge cases
- Repository renamed on GitHub — Theme Deploy picks up the rename automatically via webhook; no action needed.
- Branch deleted — the preview theme remains on your store until you delete it manually.
- Changing repositories — selecting a different repository from the repo picker replaces your deployment configuration; existing deployment history is kept.