Skip to main content

Deploying Changes

This guide covers how to deploy changes between your store environments.

Deploy Tab Overview​

The Deploy tab shows three environment cards connected by arrows, representing the flow of changes:

[Development] → [QA] → [Production]

Each card displays:

  • Environment name
  • Environment URL (clickable)
  • Last updated timestamp
  • Action buttons

Deployment Actions​

Pull from Production​

Copies your live production content to the Development environment.

Use this when:

  • Starting new development work
  • Your Development environment is out of sync
  • You want a fresh copy of production data

Steps:

  1. Click Pull from Production on the Development card
  2. Confirm the action in the modal
  3. Wait for the deployment to complete
Destructive Action

This completely replaces your Development environment. Any unsaved changes in Development will be lost.

Push Development to QA​

Merges your Development changes into the QA environment for testing.

Use this when:

  • You've completed changes in Development
  • You want to test before going live
  • You need others to review your work

Steps:

  1. Click Push Development to QA on the QA card
  2. Confirm the deployment
  3. Test your changes in the QA environment

Push QA to Production​

Deploys your tested QA changes to the live Production environment.

Use this when:

  • QA testing is complete
  • Changes have been approved
  • You're ready to go live

Steps:

  1. Click Push QA to Production on the Production card
  2. Carefully review the confirmation message
  3. Confirm to deploy to production
Production Deployment

Always verify changes in QA before deploying to Production. Production deployments affect your live customers.

Deployment Status​

During deployment, buttons show a spinner and change text:

  • "Pulling..." - Pull from Production in progress
  • "Pushing..." - Push to QA or Production in progress

All other deployment buttons are disabled while a deployment is running.

QA Readiness​

The "Push QA to Production" button is only enabled when:

  • QA has been updated more recently than Development
  • No deployment is currently in progress

This ensures you can't accidentally deploy stale changes to Production.

Cache Clearing​

Each environment card (except Development) has a cache clear button:

  • Click the archive icon to clear the cache
  • Useful after deployments if changes aren't appearing

See Cache Management for more details.