Skip to main content

Theme commands

This reference lists the Shoplazza CLI commands for theme development. For the full command reference (all topics), see the CLI command reference.

Command overview

CommandDescription
themes initScaffold a new theme based on Nova 2023
themes servePreview theme with live reload
themes pullDownload theme from store
themes pushUpload theme to store
themes shareShare a preview link
themes packagePackage theme as ZIP
themes publishPublish a theme
themes listList store themes
themes deleteDelete a theme
auth loginLog in to Shoplazza
auth logoutLog out
auth store useSwitch store
versionShow CLI version
helpShow help

Theme shortcuts

init

Scaffold a new theme based on Nova 2023.

shoplazza themes init

serve

Upload the current theme to a store and preview it with live reload.

shoplazza themes serve

This command returns:

  • A preview link that you can share with other developers
  • A link to the theme editor in the Shoplazza admin

serve flags

FlagDescription
--theme <THEME_ID>Theme ID to preview. If omitted, uses a development theme.

pull

Download theme files from Shoplazza. If no theme is specified, you are prompted to select one.

shoplazza themes pull

pull flags

FlagDescription
--theme <THEME_ID>Theme ID to pull

push

Upload local theme files to Shoplazza, overwriting the remote version.

shoplazza themes push

push flags

FlagDescription
--theme <THEME_ID>Theme ID to overwrite

share

Upload your theme as a new, unpublished theme and return a shareable preview link.

shoplazza themes share

package

Package local theme files into a ZIP file named theme_name-theme_version.zip.

shoplazza themes package

Theme API commands

list

List all themes in your store with their IDs and statuses.

shoplazza themes list --format table

publish

Publish a theme to the live store.

shoplazza themes publish --id <THEME_ID>

delete

Delete a theme from your store.

shoplazza themes delete --id <THEME_ID>

Authentication commands

login

Log in via OAuth 2.0:

shoplazza auth login --store-domain my-store.myshoplaza.com --domain themes

login flags

FlagDescription
--store-domain <domain>Store domain to connect to
--domain <domains>Business domains for scope expansion

logout

Log out and remove stored credentials:

shoplazza auth logout

store use

Switch to a different store:

shoplazza auth store use --store-domain another-store.myshoplaza.com

Utility commands

version

Display the CLI version:

shoplazza version

help

List available commands:

shoplazza help
shoplazza help [command]
shoplazza [command] --help