Skip to content
Deployify Docs

Store Matrix

Overview

Section titled “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.

Requires: Growth or Scale plan.

When to Use Store Matrix

Section titled “When to Use Store Matrix”
  • Multi-region stores (US, EU, AU)
  • Multi-brand portfolios
  • Staging → Production promotions
  • Agency client deployments

How It Works

Section titled “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 on partial failures (configurable)

Configuration

Section titled “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

Section titled “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

Section titled “Workflow Placement”
Terminal window
Checkout → Content Merge → Store Matrix → Deploy

Limits by Plan

Section titled “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

Section titled “Common Patterns”

Multi-Region

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

Staging → Production

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

Troubleshooting

Section titled “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

Section titled “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.