Shopify app and theme commands accept an auth alias

Introduced 2026-07-31 · score 0.95

HOW TO USE IT

When running a supported app or theme development command, pass `--auth-alias <alias>` or set `SHOPIFY_FLAG_AUTH_ALIAS` to use that account alias for the command without changing the current CLI session.

WHY THIS HELPS

Run app or theme development commands using a stored Shopify account alias without changing the current CLI session.

REQUIREMENTS AND LIMITATIONS

• Version: 4.6.0
• --auth-alias <value>: Alias of the Shopify account to use for authentication; provide a value when using the flag.
• SHOPIFY_FLAG_AUTH_ALIAS: Environment variable equivalent of `--auth-alias`; set it to the account alias to use.
• The flag is opted into `AppCommand`, `ThemeCommand`, and `organization list` only.

FIRST-PARTY EVIDENCE

• https://github.com/Shopify/cli/releases/tag/4.6.0
• https://github.com/Shopify/cli/pull/8026
• https://github.com/Shopify/cli/blob/4.6.0/packages/cli/README.md

Check the installed version and the source before using it. Entry JSON

Report a problem with this card