Skip to content
Deployify Docs

Your First Workflow

Overview

A workflow is a visual pipeline that defines how your theme code moves from GitHub to your Shopify store(s). This guide walks you through creating your first deployment workflow.

What is a Workflow?

A workflow consists of:

  • Blocks: Individual steps (e.g., checkout code, merge content, deploy)
  • Connections: How data flows between blocks
  • Configuration: Settings for each block (target store, theme ID, etc.)

Creating a Basic Workflow

Step 1: Open the Workflow Builder

  1. In the Deployify app, click Workflows in the sidebar
  2. Click “Create Workflow”

Step 2: Select Your Repository

  1. Choose the connected GitHub repository
  2. Select the branch (usually main or master)

Step 3: Add Workflow Blocks

A minimal deployment workflow needs:

Checkout Block (Auto-added)

  • Pulls your code from GitHub
  • No configuration needed

Content Merge Block (Recommended)

  • Merges live Shopify theme customizations with your repository code
  • Configuration:
    • Store handle: Your store’s myshopify.com domain (e.g., mystore.myshopify.com)
    • Theme ID: The theme to merge from (usually your live/published theme)

Deploy Block (Required)

  • Pushes the merged code to Shopify
  • Configuration:
    • Store handle: Target store
    • Theme ID: Target theme (can be existing or new)

Step 4: Connect the Blocks

Drag connections between blocks:

[Checkout] → [Content Merge] → [Deploy]

Step 5: Save and Test

  1. Click “Save Workflow”
  2. Give your workflow a name (e.g., “Production Deploy”)
  3. Click “Run Now” to test manually

Understanding Workflow Execution

When you run a workflow:

  1. Checkout: Fetches latest code from GitHub
  2. Content Merge (if used): Combines live Shopify changes with your repo
  3. Deploy: Pushes result to target store/theme
  4. Logs: Real-time execution logs appear in the panel

Automatic Deployment (Push-to-Deploy)

Enable automatic deployment on every Git push:

  1. Open your workflow
  2. Toggle “Auto-deploy on push” to ON

Now every push to your selected branch triggers the workflow automatically.

Workflow Limits by Plan

FeatureFreeStarterGrowthScale
Workflows15UnlimitedUnlimited
Auto-deploy✅✅✅✅
Slack alerts❌❌✅✅

Common First Workflows

Single Store Deployment

Checkout → Content Merge → Deploy to Live Theme

Multi-Store Deployment (Growth/Scale plans)

Checkout → Content Merge → Store Matrix → Deploy

Backup + Deploy (Starter+)

Checkout → Backup → Content Merge → Deploy

Troubleshooting

“Failed to save workflow”

  • Ensure all required block configurations are filled
  • Check that store handles are valid myshopify.com domains
  • Verify theme IDs are numeric (found in Shopify admin URL)

“Deployment failed”

  • Check execution logs for specific error messages
  • Common issues: invalid store credentials, theme ID doesn’t exist