FAQ
Will deployments overwrite changes made in the Shopify theme editor?
No. Before every deployment, Theme Deploy downloads your live theme's settings_data.json and settings_schema.json and injects them into the deploy. Theme editor settings (colors, fonts, section content) always survive code deploys.
Changes made in the Shopify code editor, however, are not preserved — code should always live in Git.
Which Shopify permissions does Theme Deploy use?
Only read_themes and write_themes. Theme Deploy cannot read your orders, customers, or products.
Does Theme Deploy store my code?
Your repository is cloned with short-lived GitHub App installation tokens for the duration of a deployment. Theme Deploy does not need or request permanent access tokens with broad scopes.
What are the plan limits?
| Plan | Deployments | Build minutes / month | Custom branch config |
|---|---|---|---|
| Trial (14 days) | Unlimited | Unlimited | — |
| Free | 20 / month | 15 min | — |
| Starter | Unlimited | 50 min | — |
| Pro | Unlimited | 250 min | — |
| Team | Unlimited | 500 min | Yes |
When a limit is reached, deployments are marked plan_limit_exceeded until your usage resets or you upgrade. After the 14-day trial ends, stores are moved to the Free plan automatically.
How many deployments can run at once?
Up to 3 per store. Additional pushes queue up and run in order.
Why is my push not deploying?
In order of likelihood:
- Branch rules (Team plan) — your preview option is set to Selected branches or None and the pushed branch isn't included.
- Plan limit reached — check the dashboard for
plan_limit_exceeded. - GitHub App lost access — reinstall the app on the repository (see Common Errors).
- Tag or non-branch push — only branch pushes trigger deployments.
Can I deploy to multiple stores from one repository?
Each store has its own Theme Deploy installation and configuration. Install the app on each store and select the same repository — pushes will deploy to every connected store according to each store's own branch rules.
How do I get a preview link for a branch?
Push the branch, wait for the deployment to complete, and click the preview link on the dashboard row. It looks like https://your-store.myshopify.com/?preview_theme_id=... and can be shared with anyone.
Are preview themes deleted automatically?
No. Delete old [TD] themes from Online Store → Themes when you're done with them, so you don't hit Shopify's theme limit.
Can I roll back to a previous version?
Roll back through Git — revert or reset the branch and push. See Rolling Back a Deploy.