Shopify CLI Docs

Shopify CLI for themes

Preview, test, share, push, pull, package, and publish Shopify themes.

Shopify CLI supports theme development with development themes, hot reload, Theme Check, environments, and publish workflows.

Start a theme preview

shopify theme dev --store your-store.myshopify.com

theme dev uploads the current theme as a development theme so you can preview changes against store data. Development themes are temporary, hidden, do not count toward theme limits, and are removed after inactivity.

Common theme workflow

shopify theme init
shopify theme dev
shopify theme check
shopify theme push
shopify theme publish

Authentication options

Theme commands can authenticate with:

  • Shopify account login.
  • Theme Access password using --password.
  • Custom app access token using --password with read_themes and write_themes scopes.

Ignore files

Use .shopifyignore at the root of a theme to exclude files from push/pull workflows.

Examples:

templates/product.temp.json
config/*_secret.json
*.jpg
/\.(txt|gif|bat)$/

On this page