Skip to main content
Version: 3.x

Saleor CLI

Saleor provides a convenient command-line tool to speed the development around Saleor. Using our CLI you can interact with the Saleor platform using a terminal or through an automated system to quickly create and manage Saleor environments, test storefront installation and deploy to cloud providers such as Vercel or Netlify, and more.

This page contains a complete list of all available Saleor CLI commands with their parameters.

Installing the CLI

To download and install Saleor CLI, run the following command:

npm i -g saleor-cli

From now on, you can interact with the Saleor CLI using the saleor name. If run with no parameters, it will show all available commands

saleor

░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
▄█████████████████████████████████████████▀░░░░░░░░░░░░░░░░
▄███▀ ░░░░░░░░░░░░░░░ ▄███▀░░░░░░░░░░░░░░░
▄███▀ ░░░░░░░░░░░░░░░░░▄███▀░░░░░░░░░░░░░░
▄███▀ ░░░░░░░░░░░░░░░░░░▄███▀░░░░░░░░░░░░
▄███▀ ▄███▀
▄█████████████████████████████████████████▀ Saleor Commerce CLI v0.21.0

Usage: saleor <command> [options]

Commands:
saleor info Hello from Saleor
saleor login Log in to the Saleor Cloud
saleor configure [token] Configure Saleor CLI
saleor register Create Saleor account
saleor organization [command] [aliases: org]
saleor environment [command] [aliases: env]
saleor backup [command]
saleor job [command]
saleor project [command]
saleor storefront [command] [aliases: store]
saleor telemetry [command] [aliases: tele]
saleor webhook [command] [aliases: hook]
saleor app [command]
saleor vercel [command]

Options:
-V, --version Show version number [boolean]
-h, --help Show help [boolean]

for more information, find the documentation at https://docs.saleor.io

Commands

register

The saleor register command starts the account registration process for the Saleor Cloud.

saleor register

login

The saleor login command allows you to login to your Saleor Cloud account. This will initiate an OAuth process. A browser window will open with the Saleor Cloud login page. Once authenticated, the CLI will receive an authentication token that will be stored locally for the CLI to access.

organization

The saleor organization command allows you to manage organizations in your Saleor Cloud account. You can use it to list available organizations, create new ones, remove existing ones or manage permissions for a particular organization.

Type saleor organization with no additional parameters to see a list of available sub-commands:

saleor organization [command]

Commands:
saleor org show [slug] Show a specific organization
saleor org list List organizations
saleor org create [name] Create a new organization
saleor org remove [slug] Remove the organization
saleor org permissions [slug] List organization permissions
saleor org switch [slug] Make the provided organization the default one

Options:
-V, --version Show version number [boolean]
-h, --help Show help

environment

The saleor environment command allows you to manage environments in your Saleor Cloud account. You can use it to list available environments, create new ones, remove existing ones, upgrade the Saleor engine to a specific version or manage the database for a particular environment.

Type saleor environment with no additional parameters to see a list of available sub-commands:

saleor environment [command]

Commands:
saleor env show [environment] Show a specific environment
saleor env list List environments
saleor env create [name] Create a new environment
saleor env switch [key] Make the provided environment the default on
e
saleor env remove [key] Delete an environment
saleor env upgrade [environment] Upgrade a Saleor version in a specific envi
ronment
saleor env clear <environment> Clear database for environment
saleor env populate <environment> Populate database for environment
saleor env promote [environment] Promote environment to production

Options:
-V, --version Show version number [boolean]
-h, --help Show help [boolean]

backup

The saleor backup command allows you to manage backups in your Saleor Cloud account. You can use it to list available backups, create new ones, remove existing ones or restore backups from previously stored ones.

Type saleor backup with no additional parameters to see a list of available sub-commands:

saleor backup [command]

Commands:
saleor backup list List backups
saleor backup create <name> Create a new backup
saleor backup show [backup] Show a specific backup
saleor backup restore [from] Restore a specific backup

Options:
-V, --version Show version number [boolean]
-h, --help Show help

job

The saleor job command allows you to manage asynchronous jobs in your Saleor Cloud account. You can use it to list available jobs to see their status.

Type saleor job with no additional parameters to see a list of available sub-commands:

saleor job [command]

Commands:
saleor job list List jobs

Options:
-V, --version Show version number [boolean]
-h, --help Show help

project

The saleor project command allows you to manage projects in your Saleor Cloud account. You can use it to list available projects, create new ones or remove existing ones.

Type saleor project with no additional parameters to see a list of available sub-commands:

saleor project [command]

Commands:
saleor project list List projects
saleor project create [name] Create a new project
saleor project remove [slug] Remove the organization
saleor project show [project] Show a specific project

Options:
-V, --version Show version number [boolean]
-h, --help Show help [boolean]

storefront

The saleor storefront command allows you to quickly create and deploy a storefront application that is pre-configured to use your Saleor environment.

Type saleor storefront with no additional parameters to see a list of available sub-commands:

saleor storefront [command]

Commands:
saleor storefront create [name] Boostrap example [name]
saleor storefront deploy [name] Deploy `react-storefront` to Vercel

Options:
-V, --version Show version number [boolean]
-h, --help Show help [boolean]

telemetry

The saleor telemetry command allows you to manage the telemetry status. You can disable the telemetry with saleor telemetry disable and enable it with saleor telemetry enable. By default, the telemetry is enabled. We only gather essential, anonymous data to help us improve the tool.

webhook

The saleor webhook command allows you to manage webooks of a particular environment in your Saleor Cloud account. You can use it to list available webhooks, create new ones, update and remove existing ones.

Type saleor webhook with no additional parameters to see a list of available sub-commands:

saleor webhook [command]

Commands:
saleor webhook list List webhooks for an environment
saleor webhook create Create a new backup
saleor webhook edit Edit a webhook
saleor webhook update Update webhooks for an environment

Options:
-V, --version Show version number [boolean]
-h, --help Show help [boolean]

app

The saleor app command allows you to manage Saleor apps. You can use it to list available Saleor apps, create a project structure for a new Saleor app or expose it remotely with our built-in tunneling.

Type saleor app with no additional parameters to see a list of available sub-commands:

saleor app [command]

Commands:
saleor app list List webhooks for an environment
saleor app install Install a Saleor App by URL
saleor app tunnel [port] Expose your Saleor app remotely via tunnel
saleor app create [name] Create a Saleor App template

Options:
-V, --version Show version number [boolean]
-h, --help Show help [boolean]