Required For Admin
| Value | Description |
|---|
SHOPIFY_APP_URL | The url to your store (no https://) |
SHOPIFY_CLIENT_ID | The Client ID you received when generating your app |
SHOPIFY_CLIENT_SECRET | The Client Secret you received when generating your app. |
Required For Frontend
If you are using the JavaScript publishable in the addon you'll also need to set the following.
| Value | Description |
|---|
SHOPIFY_STOREFRONT_URL | The custom url to your store if you have one (no https://) [optional] |
SHOPIFY_STOREFRONT_TOKEN | Found in the configuration section of your Headless Sales Channel |
Required For Webhooks
If you are using the webhook handlers you'll need the following.
| Value | Description |
|---|
SHOPIFY_WEBHOOK_SECRET | Found when creating your first notification. Read more about this here |
Optional
These allow you to tweak how the system works. Please check out the config/shopify.php for a full list of options.
| Value | Description |
|---|
SHOPIFY_API_VERSION | The version of the storefront and admin APIs you want to target (defaults to '2025-04'). |
SHOPIFY_ASSET_CONTAINER | The asset container you want to use to store assets (defaults to 'shopify') |
SHOPIFY_ASSET_PATH | The path in the container you want to use to store assets (defaults to ''). |
SHOPIFY_COLLECTION_HANDLE | The handle of the collection that contains your Shopify products, defaults to 'products'. |
SHOPIFY_JOB_QUEUE | The queue to run the shopify jobs on. Allows you to set it to a different one than the default. |
SHOPIFY_SALES_CHANNEL | The Sales Channel to use for product availability, defaults to 'Online Store'. |
SHOPIFY_TAXONOMY_COLLECTIONS | The taxonomy handle to use for shopify collections (defaults to 'collections'). |
SHOPIFY_TAXONOMY_TAGS | The taxonomy handle to use for 'tags' of product (defaults to 'tags'). |
SHOPIFY_TAXONOMY_TYPE | The taxonomy handle to use for 'types' of product (defaults to 'type'). |
SHOPIFY_TAXONOMY_VENDOR | The taxonomy handle to use for 'vendors' of product (defaults to 'vendor'). |
Multi-Store
Used when running multiple Shopify stores from one Statamic installation. See Multi-Store for full setup details.
| Value | Description |
|---|
SHOPIFY_MULTI_STORE_ENABLED | Set to true to enable multi-store mode (defaults to false). |
SHOPIFY_MULTI_STORE_MODE | Either unified (shared entries with per-store pricing) or localized (one entry set per Statamic site). Defaults to unified. |
SHOPIFY_MULTI_STORE_PRIMARY | The handle of the store whose data populates top-level fields in unified mode. |
Per-store credentials follow the pattern SHOPIFY_STORE_{HANDLE}_{KEY}, e.g.:
| Value | Description |
|---|
SHOPIFY_STORE_UK_URL | The .myshopify.com URL for the store (no https://). |
SHOPIFY_STORE_UK_ADMIN_TOKEN | Admin API token (or use CLIENT_ID / CLIENT_SECRET for OAuth). |
SHOPIFY_STORE_UK_STOREFRONT_TOKEN | Storefront API token. |
SHOPIFY_STORE_UK_WEBHOOK_SECRET | Webhook signing secret for this store. |
SHOPIFY_STORE_UK_API_VERSION | API version override for this store (defaults to 2025-04). |