Store Matrix

Overview

The Store Matrix block enables deploying to multiple Shopify stores simultaneously from a single workflow. Perfect for merchants running multiple regional stores or agencies managing client deployments.

Requires: Growth or Scale plan.

When to Use Store Matrix

• Multi-region stores (US, EU, AU)
• Multi-brand portfolios
• Staging → Production promotions
• Agency client deployments

How It Works

Store Matrix takes a single input (your merged theme) and:

1. Replicates the deployment to each configured store
2. Runs in parallel for faster execution
3. Reports individual results per store
4. Continues on partial failures (configurable)

Configuration

Add stores to your matrix:

Field	Description	Example
Store handle	Connected store domain	eu-store.myshopify.com
Target theme	Theme ID to deploy to	123456789 or new
Environment label	Optional tag	production, staging

Connecting Stores

Before adding to matrix:

1. Go to Stores page
2. Click “Connect Store”
3. Enter the store domain and complete OAuth authorization
4. Store appears in the matrix dropdown

Workflow Placement

Checkout → Content Merge → Store Matrix → Deploy

Limits by Plan

Plan	Matrix Stores	Parallel Deploys
Free	❌ Not available	—
Starter	❌ Not available	—
Growth	Up to 10	5 parallel
Scale	Unlimited	10 parallel

Common Patterns

Multi-Region

us-store.myshopify.com
eu-store.myshopify.com
au-store.myshopify.com

Staging → Production

Workflow 1: Checkout → Deploy to staging-store
Workflow 2: Checkout → Content Merge → Store Matrix → Deploy to prod stores

Troubleshooting

“Store not connected”

• The store must be connected via the Stores page first
• Complete the OAuth flow before adding to the matrix

“Partial deployment failure”

• Check individual store logs in execution details
• Failed stores don’t affect others unless strict mode is enabled

Comparison: Matrix vs Multiple Workflows

Approach	Pros	Cons
Store Matrix	Single workflow, parallel execution, unified reporting	All stores use same blocks
Multiple workflows	Per-store customisation, independent scheduling	More workflows to manage

Choose Matrix for consistent deployments across stores. Use separate workflows if stores need different block configurations.