Deployments
Overview
Section titled “Overview”The Deploy block is the final step in your workflow. It pushes your prepared theme code to a Shopify store.
Deployment Strategy
Section titled “Deployment Strategy”Direct
Section titled “Direct”Immediately pushes all theme files to the target store.
Deploy Block Configuration
Section titled “Deploy Block Configuration”| Setting | Required | Description |
|---|---|---|
| Store handle | ✅ | Target store (e.g., mystore.myshopify.com) |
| Theme ID | ✅ | Target theme ID |
| Strategy | ✅ | direct |
Finding Your Theme ID
Section titled “Finding Your Theme ID”- Shopify Admin → Online Store → Themes
- Click “…” → “Edit code”
- Copy the numeric ID from the URL:
/themes/123456789/
Deployment Time
Section titled “Deployment Time”| Theme Size | Estimated Time |
|---|---|
| Small (< 5MB) | 10–30 seconds |
| Medium (5–20MB) | 30–60 seconds |
| Large (20–100MB) | 1–3 minutes |
| Very Large (> 100MB) | 3–5+ minutes |
Cancelling a Running Deployment
Section titled “Cancelling a Running Deployment”- Open your workflow in the builder
- Click Runs to open the Run History panel
- Find the active run and click the red Cancel button
Cancellation is checked between each pipeline step, any step already in progress will complete before stopping.
Note: Cancelled runs show an orange cancelled badge and do not count as failures for Slack notifications.
Rollback
Section titled “Rollback”If deployment causes issues:
- Use Backups - restore from backup (if enabled on your plan)
- Redeploy previous version - push last known good commit to GitHub
- Manual revert - in Shopify Admin, revert to a previous theme version
Best Practices
Section titled “Best Practices”- Always backup first. Use the Backup block before Deploy
- Test on a preview theme before deploying to your live theme
- Use Content Merge to preserve admin changes
- Avoid peak traffic hours for major theme changes