Skip to main content

app

Manage Saleor Apps

app

$ saleor app --help

Help output:

saleor app [command]

Manage Saleor Apps

Commands:
saleor app list List installed Saleor Apps for an environment
saleor app install Install a Saleor App by URL
saleor app uninstall <app-id> Uninstall a Saleor App by ID. You need to provide `appId`. List available apps and their IDs with `saleor app list`.
saleor app create [name] Create a new Saleor Local App
saleor app tunnel [port] Expose your Saleor app remotely with ngrok tunnel
saleor app token Create a Saleor App token
saleor app permission Add or remove permission for a Saleor App
saleor app template [name] Create an App with Saleor App Template
saleor app remove [app-id] Create a new Saleor Local App

Options:
--json Output the data as JSON [boolean] [default: false]
--short Output data as text [boolean] [default: false]
-u, --instance, --url Saleor instance API URL (must start with the protocol, i.e. https:// or http://) [string]
-V, --version Show version number [boolean]
-h, --help Show help [boolean]
Expand ▼

app list

$ saleor app list --help

Help output:

saleor app list

List installed Saleor Apps for an environment

Options:
--json Output the data as JSON [boolean] [default: false]
--short Output data as text [boolean] [default: false]
-u, --instance, --url Saleor instance API URL (must start with the protocol, i.e. https:// or http://) [string]
-V, --version Show version number [boolean]
-h, --help Show help [boolean]

Examples:
saleor app list

app install

$ saleor app install --help

Help output:

saleor app install

Install a Saleor App by URL

Options:
--json Output the data as JSON [boolean] [default: false]
--short Output data as text [boolean] [default: false]
-u, --instance, --url Saleor instance API URL (must start with the protocol, i.e. https:// or http://) [string]
--via-dashboard [boolean] [default: false]
--app-name Application name [string]
--manifest-URL Application Manifest URL [string]
-V, --version Show version number [boolean]
-h, --help Show help [boolean]

Examples:
saleor app install --manifest-URL="https://my-saleor-app.com/api/manifest
saleor app install --manifest-URL="https://my-saleor-app.com/api/manifest --app-name="Saleor app"
saleor app install --organization="organization-slug" --environment="env-id-or-name" --app-name="Saleor app" --manifest-URL="https://my-saleor-app.com/api/manifest"

app uninstall

$ saleor app uninstall --help

Help output:

saleor app uninstall <app-id>

Uninstall a Saleor App by ID. You need to provide `appId`. List available apps and their IDs with `saleor app list`.

Positionals:
app-id The Saleor App id [string] [required]

Options:
--json Output the data as JSON [boolean] [default: false]
--short Output data as text [boolean] [default: false]
-u, --instance, --url Saleor instance API URL (must start with the protocol, i.e. https:// or http://) [string]
-V, --version Show version number [boolean]
-h, --help Show help [boolean]

Examples:
saleor app uninstall app-id
saleor app uninstall app-id --organization="organization-slug" --environment="env-id-or-name"

app create

$ saleor app create --help

Help output:

saleor app create [name]

Create a new Saleor Local App

Positionals:
name name for the new Local App [string]

Options:
--json Output the data as JSON [boolean] [default: false]
--short Output data as text [boolean] [default: false]
-u, --instance, --url Saleor instance API URL (must start with the protocol, i.e. https:// or http://) [string]
--permissions The array of permissions [array]
-V, --version Show version number [boolean]
-h, --help Show help [boolean]

Examples:
saleor app create --name="my saleor app" --permissions=MANAGE_USERS --permissions=MANAGE_STAFF
saleor app create --name="my saleor app" --organization="organization-slug" --environment="env-id-or-name" --permissions=MANAGE_USERS --permissions=MANAGE_STAFF

app tunnel

$ saleor app tunnel --help

Help output:

saleor app tunnel [port]

Expose your Saleor app remotely with ngrok tunnel

Positionals:
port [number] [default: 3000]

Options:
--json Output the data as JSON [boolean] [default: false]
--short Output data as text [boolean] [default: false]
-u, --instance, --url Saleor instance API URL (must start with the protocol, i.e. https:// or http://) [string]
--name The application name for installation in the Dashboard [string]
--force-install Force the Saleor App Install [boolean] [default: false]
--manifest-path The application's manifest path [string] [default: "/api/manifest"]
-V, --version Show version number [boolean]
-h, --help Show help [boolean]

Examples:
saleor app tunnel --name="Custom name"
saleor app tunnel --force-install
saleor app tunnel --manifest-path="/app/manifest"
saleor app tunnel --organization="organization-slug" --environment="env-id-or-name"
Expand ▼

app token

$ saleor app token --help

Help output:

saleor app token

Create a Saleor App token

Options:
--json Output the data as JSON [boolean] [default: false]
--short Output data as text [boolean] [default: false]
-u, --instance, --url Saleor instance API URL (must start with the protocol, i.e. https:// or http://) [string]
--app-id The Saleor App id [string]
-V, --version Show version number [boolean]
-h, --help Show help [boolean]

Examples:
saleor app token
saleor app token --app-id="app-id"
saleor app token --app-id="app-id=" --organization="organization-slug" --environment="env-id-or-name"

app permission

$ saleor app permission --help

Help output:

saleor app permission

Add or remove permission for a Saleor App

Options:
--json Output the data as JSON [boolean] [default: false]
--short Output data as text [boolean] [default: false]
-u, --instance, --url Saleor instance API URL (must start with the protocol, i.e. https:// or http://) [string]
--app-id The Saleor App id [string]
--permissions The array of permissions [array]
-V, --version Show version number [boolean]
-h, --help Show help [boolean]

Examples:
saleor app permission --app-id="app-id" --permissions=MANAGE_USERS --permissions=MANAGE_STAFF
saleor app permission --organization="organization-slug" --environment="env-id-or-name" --app-id="app-id" --permissions=MANAGE_USERS --permissions=MANAGE_STAFF

app template

$ saleor app template --help

Help output:

saleor app template [name]

Create an App with Saleor App Template

Positionals:
name [string] [default: "my-saleor-app"]

Options:
--json Output the data as JSON [boolean] [default: false]
--short Output data as text [boolean] [default: false]
-u, --instance, --url Saleor instance API URL (must start with the protocol, i.e. https:// or http://) [string]
--dependencies, --deps [boolean] [default: true]
-t, --template, --repo, --repository [string] [default: "saleor/saleor-app-template"]
-b, --branch [string] [default: "main"]
-e, --example [string]
-V, --version Show version number [boolean]
-h, --help Show help [boolean]

app remove

$ saleor app remove --help

Help output:

saleor app remove [app-id]

Create a new Saleor Local App

Options:
--json Output the data as JSON [boolean] [default: false]
--short Output data as text [boolean] [default: false]
-u, --instance, --url Saleor instance API URL (must start with the protocol, i.e. https:// or http://) [string]
--app-id The Saleor App id [string]
--force skip confirmation prompt [boolean]
-V, --version Show version number [boolean]
-h, --help Show help [boolean]

Examples:
saleor app remove
saleor app remove --app-id="app-id" --environment="env-id-or-name" --force