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.

shell
shoplazza themes init --name <dir>

serve​

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

shell
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-id, -t <THEME_ID>Theme ID to preview. If omitted, uses a development theme.

pull​

Download theme files from Shoplazza.

shell
shoplazza themes pull --theme-id <THEME_ID>

pull flags​

FlagDescription
--theme-id, -t <THEME_ID>Theme ID to pull (required). Run shoplazza themes list to discover.

push​

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

shell
shoplazza themes push --theme-id <THEME_ID>

push flags​

FlagDescription
--theme-id, -t <THEME_ID>Theme ID to overwrite (required). Run shoplazza themes list to discover.

share​

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

shell
shoplazza themes share

package​

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

shell
shoplazza themes package

Theme API commands​

list​

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

shell
shoplazza themes list --format table

publish​

Publish a theme to the live store.

shell
shoplazza themes publish --id <THEME_ID>

delete​

Delete a theme from your store.

shell
shoplazza themes delete --id <THEME_ID>

Authentication commands​

login​

Log in via OAuth 2.0:

shell
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:

shell
shoplazza auth logout

store use​

Switch to a different store:

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

Utility commands​

version​

Display the CLI version:

shell
shoplazza version

help​

List available commands:

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