Deployments

Overview

The Deploy block is the final step in your workflow — it pushes your prepared theme code to a Shopify store.

Deployment Strategies

Direct Deployment (All Plans)

Immediately pushes all theme files to the target store. Fastest option — all visitors see changes right away.

When to use: Development/staging environments, small low-risk changes, urgent hotfixes.

Progressive Deployment (Growth/Scale Plans)

Rolls out changes gradually — starts with 10% of traffic, increases to 100% while monitoring for errors.

When to use: High-traffic production stores, major theme updates, risk-averse deployments.

Deploy Block Configuration

Setting	Required	Description
Store handle	✅	Target store (e.g., mystore.myshopify.com)
Theme ID	✅	Target theme ID or new for new theme
Strategy	✅	direct or progressive

Finding Your Theme ID

1. Shopify Admin → Online Store → Themes
2. Click ”…” → “Edit code”
3. Copy the numeric ID from the URL: /themes/123456789/

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

1. Open your workflow in the builder
2. Click Runs to open the Run History panel
3. 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

If deployment causes issues:

1. Use Backups — restore from backup (if enabled on your plan)
2. Redeploy previous version — push last known good commit to GitHub
3. Manual revert — in Shopify Admin, revert to a previous theme version

Best Practices

1. Always backup first — use the Backup block before Deploy
2. Test on a preview theme before deploying to your live theme
3. Use Content Merge to preserve admin changes
4. Avoid peak traffic hours for major theme changes

Plan Availability

Feature	Free	Starter	Growth	Scale
Direct deployment	✅	✅	✅	✅
Progressive deployment	❌	❌	✅	✅