Store Matrix

Overview

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

Store Matrix is available on all plans. The number of connected stores follows your plan’s store limit.

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. Reports individual results per store
3. Continues to remaining stores after one target fails, then marks the overall execution failed

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
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

Store Matrix → Checkout → Backup → Content Merge → Deploy

Limits by Plan

Plan	Matrix Stores
Free	1
Starter	3
Growth	10
Scale	Unlimited

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

Logs show 📦 [] Starting... and No access token found

• The empty brackets mean the Store Matrix has an incomplete row
• Select both a connected store and target theme in the Store Matrix
• Save the workflow before running it again
• Connecting a store makes it available for selection; it does not automatically add it to the workflow

“Partial deployment failure”

• Check individual store logs in execution details
• Remaining stores still run, but any failed target marks the overall execution failed

Comparison: Matrix vs Multiple Workflows

Approach	Pros	Cons
Store Matrix	Single workflow, unified reporting	Stores run sequentially and use the 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.