Statamic Shopify

https://statamic-shopify-docs.vercel.app/
Admin
Integrates Shopify's e-commerce capabilities with Statamic CMS, allowing developers to leverage...
Tokens:21,651
Snippets:98
Trust Score:7.8
Update:1 year ago
Show doc for...
Tokens:
Raw
### Publish Statamic Shopify Content Assets

Source: https://statamic-shopify-docs.vercel.app/setup

Publishes content-related assets for the Statamic Shopify integration, such as initial data or example content structures.

```bash
php artisan vendor:publish --tag="shopify-content"
```

--------------------------------

### Publish All Statamic Shopify Assets

Source: https://statamic-shopify-docs.vercel.app/setup

Publishes all assets provided by the Statamic Shopify plugin, including configuration, blueprints, content, and JavaScript files. This command is useful for a quick setup.

```bash
php artisan vendor:publish --provider="StatamicRadPack\Shopify\ServiceProvider"
```

--------------------------------

### Final .env Configuration for Statamic Shopify

Source: https://statamic-shopify-docs.vercel.app/setup

An example of the complete .env file configuration required after setting up both the Storefront API and Admin API for the Statamic Shopify integration.

```dotenv
SHOPIFY_APP_URL="your-store.myshopify.com"
SHOPIFY_STOREFRONT_TOKEN="{Public access token}"
SHOPIFY_SALES_CHANNEL="{Sales channel name}"
SHOPIFY_ADMIN_TOKEN="{Admin API access token}"
```

--------------------------------

### Publish Statamic Shopify Theme Files

Source: https://statamic-shopify-docs.vercel.app/setup

Publishes the starter theme files for the Statamic Shopify integration. This command allows you to quickly set up the theme or inspect the JavaScript integration.

```php
php artisan vendor:publish --tag="shopify-theme"
```

--------------------------------

### Publish Statamic Shopify JavaScript Files

Source: https://statamic-shopify-docs.vercel.app/setup

Publishes the JavaScript files that assist in integrating with the Shopify Storefront API, speeding up frontend development.

```bash
php artisan vendor:publish --tag="shopify-scripts"
```

--------------------------------

### Publish Statamic Shopify Blueprints

Source: https://statamic-shopify-docs.vercel.app/setup

Publishes only the blueprint assets for Statamic Shopify, which include configurations for Products, Variants, and Taxonomies.

```bash
php artisan vendor:publish --tag="shopify-blueprints"
```

--------------------------------

### Publish Statamic Shopify Configuration

Source: https://statamic-shopify-docs.vercel.app/setup

Publishes the configuration file for the Statamic Shopify plugin, allowing customization of its settings.

```bash
php artisan vendor:publish --tag="shopify-config"
```

--------------------------------

### Install Statamic Shopify Composer Package

Source: https://statamic-shopify-docs.vercel.app/setup

Installs the Statamic Shopify integration package using Composer. This is the initial step for adding the plugin to your Statamic project.

```bash
composer require statamic-rad-pack/shopify
```

--------------------------------

### Configure Storefront API Credentials

Source: https://statamic-shopify-docs.vercel.app/setup

Sets the environment variables for connecting to the Shopify Storefront API. These values are obtained from a Shopify Headless app's sales channel credentials.

```bash
SHOPIFY_APP_URL="your-store.myshopify.com"
SHOPIFY_STOREFRONT_TOKEN="{Public access token}"
SHOPIFY_SALES_CHANNEL="{Sales channel name}"
```

--------------------------------

### Publish Shopify Theme Assets

Source: https://statamic-shopify-docs.vercel.app/frontend/getting-started

This command publishes the necessary theme assets for Shopify integration, allowing you to use example templates for cart, product, and products pages on your frontend.

```PHP
php artisan vendor:publish --tag="shopify-theme"
```

--------------------------------

### Publish Shopify Theme Files

Source: https://statamic-shopify-docs.vercel.app/frontend/storefront-api

Publishes the theme files for the Shopify integration, allowing for quick setup of an example integration.

```bash
php artisan vendor:publish --tag="shopify-theme"
```

--------------------------------

### Install Shopify Storefront API Client (NPM)

Source: https://statamic-shopify-docs.vercel.app/frontend/storefront-api

Installs the necessary Shopify Storefront API client package using NPM.

```bash
npm install @shopify/storefront-api-client --save
```

--------------------------------

### Fix: Installation errors

Source: https://statamic-shopify-docs.vercel.app/releases

This fix resolves errors encountered during the installation process of the Statamic Shopify integration. It ensures a smoother and more reliable setup experience.

```php
Fix installation errors @ryanmitchell (#235)
```

--------------------------------

### Install Shopify Storefront API Client (Yarn)

Source: https://statamic-shopify-docs.vercel.app/frontend/storefront-api

Installs the necessary Shopify Storefront API client package using Yarn.

```bash
yarn add @shopify/storefront-api-client
```

--------------------------------

### Statamic Shopify v6.2.1 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details a fix in version 6.2.1 of the Statamic Shopify integration, specifically updating frontend examples. References a GitHub pull request.

```Markdown
##  v6.2.1 7/16/2025
## What's Fixed
  * Update frontend examples by @daun in https://github.com/statamic-rad-pack/shopify/pull/301

**Full Changelog** : https://github.com/statamic-rad-pack/shopify/compare/v6.2.0...v6.2.1
```

--------------------------------

### Configure Shopify Webhooks for Collection Updates

Source: https://statamic-shopify-docs.vercel.app/upgrading

Following changes in collection processing, webhooks for collection create, update, and delete events must now be configured. Refer to the webhooks documentation for detailed setup instructions.

```text
Due to the changes to how collections are processed, you will now need to set up webhooks for collection create, collection update, and collection delete. See the webhooks documentation for full details.
```

--------------------------------

### Update Shopify Token Output Structure

Source: https://statamic-shopify-docs.vercel.app/upgrading

The output structure for the `{{ shopify:tokens }}` tag has been updated. `window.shopifyUrl` is now accessible via `window.shopifyConfig.url`, and `window.shopifyToken` is now accessible via `window.shopifyConfig.token`.

```javascript
The output of `{{ shopify:tokens }}` has changed, so that `window.shopifyUrl` is now `window.shopifyConfig.url` and `window.shopifyToken` is now `window.shopifyConfig.token`.
```

--------------------------------

### Statamic Shopify v5.0.3 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details a fix in version 5.0.3 of the Statamic Shopify integration, specifying that blueprint installation should use a YAML file rather than parsing YAML. References a GitHub pull request.

```Markdown
##  v5.0.3 11/22/2024
## 🐛 Fixed
  * Installing blueprint should use YAML file, not YAML parse @ryanmitchell (#257)
```

--------------------------------

### Maintenance: Remove Product Create on setup

Source: https://statamic-shopify-docs.vercel.app/releases

This maintenance update removes the 'Product Create' functionality from the setup process. This change is intended to streamline the initial setup by removing a potentially unnecessary step.

```php
We don't need Product Create on setup @ryanmitchell (#243)
```

--------------------------------

### Update Shopify Tag Syntax (Statamic to Shopify)

Source: https://statamic-shopify-docs.vercel.app/upgrading

This section details the renaming and restructuring of Statamic Shopify tags for improved consistency and adherence to Shopify's conventions. It highlights the prefixing of most tags with 'shopify' and provides specific examples of old vs. new tag syntax.

```statamic
{{ shopify_tokens }} is now {{ shopify:tokens }}
{{ product_price }} is now {{ shopify:product_price }}
{{ product_variants:generate }} is now {{ shopify:variants:generate }}
{{ product_variants:loop }} is now {{ shopify:variants }}
{{ product_variants:from_title }} no longer exists, use {{ shopify:variants title:is="title_value" }}
{{ product_variants:from_index }} no longer exists, use {{ {shopify:variants}[index] }}
{{ in_stock }} is now {{ shopify:in_stock }}
```

--------------------------------

### Update Statamic Shopify Frontend Integration (Alpine.js)

Source: https://statamic-shopify-docs.vercel.app/upgrading

This section addresses breaking changes in frontend integrations due to the migration to the Shopify Storefront Checkout API. Previous JavaScript integrations are no longer supported, and a move to the new Alpine.js integration is strongly recommended. Updated JavaScript files are available for a like-for-like replacement, but code changes will still be necessary.

```javascript
Due to the essential migration to the Shopify Storefront Checkout API, any previous Javascript integrations that relied on the supplied Javascript files will no longer continue to work. Code updates will be required. We strongly recommend taking this opportunity to move to the newly provided Alpine.js integration (See the Storefront API documentation for details on this). If however you want a like for like replacement, you can find updated JS files here. You will still need to make code changes, however these Javascript files are in line with what was previously supplied.
```

--------------------------------

### Statamic Shopify v5.2.0 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details new features in version 5.2.0 of the Statamic Shopify integration, including removing hardcoded API versions from the JS client and using the storage facade to get the real path. References GitHub pull requests.

```Markdown
##  v5.2.0 1/29/2025
## 🚀 New
  * Remove hardcoded API version from JS client @ryanmitchell (#272)
  * Use storage facade to get real path @ryanmitchell (#271)
```

--------------------------------

### Configure Required Statamic Shopify .env Variables

Source: https://statamic-shopify-docs.vercel.app/upgrading

This update requires several new environment variables for the Statamic Shopify integration to function. Ensure the following variables are defined in your `.env` file: `SHOPIFY_ADMIN_TOKEN`, `SHOPIFY_AUTH_KEY`, `SHOPIFY_AUTH_PASSWORD`, and `SHOPIFY_WEBHOOK_SECRET`.

```env
The following .env variables are now required:
`SHOPIFY_ADMIN_TOKEN`
`SHOPIFY_AUTH_KEY`
`SHOPIFY_AUTH_PASSWORD`
`SHOPIFY_WEBHOOK_SECRET`
```

--------------------------------

### Enable Shopify Product Publish Date Support

Source: https://statamic-shopify-docs.vercel.app/upgrading

To ensure product status and publish dates correctly reflect Shopify settings, the 'Products' collection must have 'Publish Dates' enabled. Configure 'Past Date Behavior' to 'public' and 'Future Date Behavior' to 'hidden'.

```text
Product status and publish dates now respect the settings from Shopify. To enable date support ensure your Products collection has `Publish Dates` enabled, with `Past Date Behavior` public, and `Future Date Behavior` hidden.
```

--------------------------------

### Update Shopify Product Import Job Parameters

Source: https://statamic-shopify-docs.vercel.app/upgrading

This explains modifications to the `ImportCollectionJob` and `ImportSingleProductJob` classes. These jobs no longer accept arrays for their parameters; instead, they require the unique ID of the product to be updated. The `ImportAllProductsJob` has been removed entirely.

```php
`ImportCollectionJob` and `ImportSingleProductJob` no longer accept arrays, instead they accept the unique ID of the product you want to update.
`ImportAllProductsJob` has been removed entirely.
```

--------------------------------

### Access Shopify Tokens in Antlers

Source: https://statamic-shopify-docs.vercel.app/frontend/getting-started

This Antlers tag provides easy access to your Storefront API Token and site URL directly from your frontend templates, simplifying API interactions.

```Antlers
{{ shopify_tokens }}
```

--------------------------------

### Initialize Shopify API Client

Source: https://statamic-shopify-docs.vercel.app/frontend/storefront-api

Imports the Shopify API client, which uses configuration generated by `{{ shopify:tokens }}` to establish a connection to Shopify's GraphQL API.

```javascript
import client from 'vendor/shopify/client';
```

--------------------------------

### Import All Shopify Products via CLI

Source: https://statamic-shopify-docs.vercel.app/CMS/importing-data

Fetches all products from Shopify and runs them through the updater using the Artisan command line interface.

```bash
php artisan shopify:import:all
```

--------------------------------

### Statamic Shopify User Creation Configuration

Source: https://statamic-shopify-docs.vercel.app/CMS/customers

Enable Statamic to create new users when customers are created in Shopify by setting `create_users_from_shopify` to true in the `shopify.php` configuration file.

```PHP
'create_users_from_shopify' => true,
```

--------------------------------

### Publish Shopify Scripts

Source: https://statamic-shopify-docs.vercel.app/frontend/storefront-api

Publishes the uncompiled JavaScript assets for the Shopify integration to your resources directory using a vendor publish command.

```bash
php artisan vendor:publish --tag="shopify-scripts"
```

--------------------------------

### Statamic Shopify Customer Create Webhook

Source: https://statamic-shopify-docs.vercel.app/CMS/customers

Configure a webhook for customer creation in Shopify to send data to Statamic and queue customer imports. This requires 'customer read' and 'customer write' permissions on your Shopify app.

```Bash
https://YOURSITE/!/shopify/webhook/customer/create
```

--------------------------------

### Alpine.js Storefront Integration

Source: https://statamic-shopify-docs.vercel.app/frontend/storefront-api

Sets up an Alpine.js store and helper functions for interacting with the Shopify integration. This code assumes it's included in your site.js file.

```javascript
import { createData, createStore } from './vendor/shopify/alpine';
import Alpine from 'alpinejs';

window.Alpine = Alpine;

createStore(Alpine);
createData(Alpine);

Alpine.start();

```

--------------------------------

### Add Shopify API Scopes for Metaobjects and Publications

Source: https://statamic-shopify-docs.vercel.app/upgrading

Your Statamic Shopify integration now requires additional API scopes to function correctly. Ensure your application has the `read_publications` and `read_metaobjects` scopes enabled in your Shopify settings.

```text
Your app needs to add the `read_publications` and `read_metaobjects` scopes.
```

--------------------------------

### Statamic Shopify v6.1.0 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details changes in version 6.1.0 of the Statamic Shopify integration, including using the actual CP URL for product list fetching, adjusting CP navigation for custom taxonomy handles, filtering taxonomies before import, and enabling multisite product collection import. References GitHub pull requests and notes a new contributor.

```Markdown
##  v6.1.0 7/13/2025
## What's Changed
  * Use actual CP url for fetching product list by @daun in https://github.com/statamic-rad-pack/shopify/pull/296
  * Adjust CP nav to work with customized taxonomy handles and names by @daun in https://github.com/statamic-rad-pack/shopify/pull/295
  * Filter taxonomies before importing by @daun in https://github.com/statamic-rad-pack/shopify/pull/297
  * Get multisite product collection import working by @daun in https://github.com/statamic-rad-pack/shopify/pull/294


## New Contributors
  * @daun made their first contribution in https://github.com/statamic-rad-pack/shopify/pull/296


**Full Changelog** : https://github.com/statamic-rad-pack/shopify/compare/v6.0.0...v6.1.0
```

--------------------------------

### Update Statamic Shopify URL Structure

Source: https://statamic-shopify-docs.vercel.app/upgrading

This describes the change in URL structure for Statamic Shopify integration, affecting action URLs, webhook URLs, and publish URLs. The base path has been updated from 'statamic-shopify' to 'shopify' for all related endpoints.

```text
Action URLs, webhook URLs or publish URLs have been changed from `statamic-shopify` to `shopify` e.g. the Product Create webhook is now `https://YOURSITE/!/shopify/webhook/product/create`
```

--------------------------------

### Update Shopify Form Field Naming Convention

Source: https://statamic-shopify-docs.vercel.app/upgrading

This section advises on changes to form field names within the `{{ shopify:address_form }}` tag. Field names should now use camelCase instead of snake_case to align with Shopify's GraphQL mutations input requirements.

```html
If you were using the `{{ shopify:address_form }}` tag, any form fields names should now be camelCase, not snake_case, in line with what Shopify's GraphQL mutations expect: https://shopify.dev/docs/api/storefront/2024-10/input-objects/MailingAddressInput
```

--------------------------------

### New: Programmatic creation of collections, taxonomies, and asset containers

Source: https://statamic-shopify-docs.vercel.app/releases

This new feature allows for the programmatic creation of collections, taxonomies, and asset containers. This enhances automation capabilities by enabling these elements to be generated via code.

```php
Create collections, taxonomies and asset containers programatically @ryanmitchell (#233)
```

--------------------------------

### Statamic Shopify v6.3.0 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details changes in version 6.3.0 of the Statamic Shopify integration, including conditional 'from' prefix display, handling negative inventory, adding an .env var for API version, and passing currency/price to out-of-stock messages. References specific GitHub pull requests.

```Markdown
##  v6.3.0 7/24/2025
## What's Changed
  * Only display `from` prefix if prices differ by @daun in https://github.com/statamic-rad-pack/shopify/pull/305
  * Count negative inventory values as out of stock by @daun in https://github.com/statamic-rad-pack/shopify/pull/307
  * Add .env var for api_version by @ryanmitchell in https://github.com/statamic-rad-pack/shopify/pull/308
  * Pass currency and price to out of stock message @daun in https://github.com/statamic-rad-pack/shopify/pull/306

**Full Changelog** : https://github.com/statamic-rad-pack/shopify/compare/v6.2.2...v6.3.0
```

--------------------------------

### Statamic Shopify v5.0.1 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Notes a bad release for version 5.0.1 of the Statamic Shopify integration and provides a link to the full changelog.

```Markdown
##  v5.0.1 11/4/2024
Fix bad release
**Full Changelog** : https://github.com/statamic-rad-pack/shopify/compare/v5.0.0...v5.0.1
```

--------------------------------

### Statamic Shopify: Filter Variants on Sale

Source: https://statamic-shopify-docs.vercel.app/frontend/scopes

This Statamic tag allows filtering the 'variants' collection to include only items that are currently on sale. It's useful for creating dedicated sale pages. The example demonstrates grouping filtered variants by product slug and displaying product titles and SKUs with prices.

```Statamic
{{ collection:variants query_scope="variant_is_on_sale" as="variants" }}

   {{ variants group_by="product_slug" }}
      {{ groups }}
          {{ collection:products :slug:is="product_slug" limit="1" as="product" }}
              {{ product:title }}
              {{ items }}       
                 {{ sku }} - Price: £{{ price }} (was: £{{ compare_at_price }})
              {{ /items }}
          {{ /collection:products }}
      {{ /groups }}
   {{ /variants }}

{{ /collection:variants }}
```

--------------------------------

### Update Shopify API Version and GraphQL Usage

Source: https://statamic-shopify-docs.vercel.app/upgrading

This highlights the removal of support for the deprecated Shopify REST API in favor of GraphQL. All API calls have been replaced with GraphQL equivalents, and the default API version is now `2025-04`. Developers using the REST API in custom code will need to update their implementations.

```graphql
We now target api version `2025-04` by default.
```

--------------------------------

### Statamic Shopify Customer Orders Tag with Pagination

Source: https://statamic-shopify-docs.vercel.app/frontend/tags

Illustrates how to implement pagination for the `shopify:customer:orders` tag using the `paginate` parameter. This is useful for managing large sets of customer orders efficiently.

```html
{{ shopify:customer:orders paginate="10" }} ... {{ /shopify:customer:orders }}
```

--------------------------------

### Update Shopify Variant and Weight Data Access

Source: https://statamic-shopify-docs.vercel.app/upgrading

This details changes in how variant and weight information is accessed. `storefront_id` is replaced by `variant_id`. `inventory_management` is no longer considered for stock levels as it's not returned by GraphQL. Variant weight data is now accessed via a `weight` subfield containing `unit` and `value`.

```statamic
`storefront_id` is no longer available on variants, please use `variant_id` instead.
`inventory_management` is no longer taken into consideration for stock levels as it is not returned by GraphQL.
`grams` is no longer available on variants, instead use `weight` which contains `unit` and `value` subfields.
```

--------------------------------

### Statamic Shopify v5.3.0 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details new features and fixes in version 5.3.0 of the Statamic Shopify integration. New features include adding a product-price hook. Fixes include correcting a publish date comparison and documenting ENV variable settings. References GitHub pull requests.

```Markdown
##  v5.3.0 4/25/2025
## 🚀 New
  * Add product-price hook @ryanmitchell (#286)


## 🐛 Fixed
  * Publish date should be lt not gt @ryanmitchell (#284)
  * Document setting of ENV Variables @anditopping (#273)
```

--------------------------------

### Statamic Shopify: Filter Variants by Product

Source: https://statamic-shopify-docs.vercel.app/frontend/scopes

This Statamic tag enables filtering the 'variants' collection to retrieve variants associated with a specific product slug. It's commonly used on single product pages to display available variants. The example shows how to render a select dropdown for multiple variants or a hidden input for a single variant.

```Statamic
{{ collection:variants query_scope="variant_by_product" :product="slug" as="variants" }}

    {{ if total_results > 1 }}

        <select name="ss-product-variant" id="ss-product-variant" class="mb-2 p-2 border">
            {{ variants }}
                <option value="{{ storefront_id }}">{{ title }} - £{{ price }}</option>
            {{ /variants}}
        </select>

    {{ else }}

        {{ variants }}
            <input type="hidden" name="ss-product-variant" id="ss-product-variant" value="{{ storefront_id }}">
        {{ /variants}}

    {{ /if }}

{{ /collection:variants }}
```

--------------------------------

### Statamic Shopify v5.0.6 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details a fix in version 5.0.6 of the Statamic Shopify integration, addressing the created_at field on order creation. References a GitHub pull request.

```Markdown
##  v5.0.6 11/29/2024
## 🐛 Fixed
  * Fix created_at on order create @ryanmitchell (#263)
```

--------------------------------

### Statamic Shopify v6.2.2 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details fixes in version 6.2.2 of the Statamic Shopify integration, including resolving entry creation errors and ensuring inventory policy checks are case-insensitive. References specific GitHub pull requests.

```Markdown
##  v6.2.2 7/21/2025
## What's Fixed
  * Fix entry creation errors by @ryanmitchell in https://github.com/statamic-rad-pack/shopify/pull/302
  * Ensure inventory_policy checks are lower cased by @ryanmitchell in https://github.com/statamic-rad-pack/shopify/pull/304

**Full Changelog** : https://github.com/statamic-rad-pack/shopify/compare/v6.2.1...v6.2.2
```

--------------------------------

### Statamic Shopify v5.0.4 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details fixes in version 5.0.4 of the Statamic Shopify integration, including updating publishable views to Alpine and handling empty images during import. References GitHub pull requests.

```Markdown
##  v5.0.4 11/28/2024
## 🐛 Fixed
  * Update publishable views to Alpine @ryanmitchell (#260)
  * Handle empty images in import @ryanmitchell (#259)
```

--------------------------------

### Statamic Shopify v5.0.0 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details new features and fixes in version 5.0.0 of the Statamic Shopify integration. New features include moving to shopfront-api checkouts and providing agnostic JS and Alpine helpers. Fixes include renaming 'types' to 'type' in the product template. References GitHub pull requests.

```Markdown
##  v5.0.0 11/4/2024
## 🚀 New
  * Move to shopfront-api checkouts, provide agnostic JS and alpine helper @ryanmitchell (#241)


## Fixed
  * Types needs renamed to type in the product template @sunscreem (#246)
```

--------------------------------

### Statamic Shopify v5.0.7 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details a fix in version 5.0.7 of the Statamic Shopify integration, ensuring quantities are updated correctly. References a GitHub pull request.

```Markdown
##  v5.0.7 12/3/2024
## 🐛 Fixed
  * Update quantities correctly @ryanmitchell (#265)
```

--------------------------------

### Statamic Shopify v6.0.0 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Highlights new features in version 6.0.0 of the Statamic Shopify integration, including the removal of RestAPI calls in favor of GraphQL and the introduction of a configurable Statamic collection handle. References GitHub pull requests.

```Markdown
##  v6.0.0 5/29/2025
## 🚀 New
  * Remove RestAPI calls and move entirely to GraphQL @ryanmitchell (#290)
  * Configurable Statamic collection handle @johncarter- (#283)
```

--------------------------------

### Display Product Price

Source: https://statamic-shopify-docs.vercel.app/frontend/tags

Displays the price of a product, optionally showing a 'From' prefix for products with multiple variants. Returns 'out of stock' if the product is unavailable.

```Statamic Tag
{{ shopify:product_price show_from="true" }}
```

```Text
Out of Stock

// or

From £50.00 

// or 

£4.99
```

--------------------------------

### Statamic Shopify v6.4.0 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details changes in version 6.4.0 of the Statamic Shopify integration, including allowing sales channels to be determined by a config value. References a specific GitHub pull request for the change.

```Markdown
##  v6.4.0 7/25/2025
## What's Changed
  * Allow sales channel to be determined by a config value by @ryanmitchell in https://github.com/statamic-rad-pack/shopify/pull/309

**Full Changelog** : https://github.com/statamic-rad-pack/shopify/compare/v6.3.0...v6.4.0
```

--------------------------------

### Statamic Shopify v5.1.0 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details new features and fixes in version 5.1.0 of the Statamic Shopify integration. New features include updating address forms to support precognition. Fixes include only showing the Nav group if the user has access and passing the Alpine instance to createStore and createData. References GitHub pull requests.

```Markdown
##  v5.1.0 1/3/2025
## 🚀 New
  * Update address forms to support precognition @ryanmitchell (#269)


## 🐛 Fixed
  * Only show Nav group if user has some access @ryanmitchell (#268)
  * Pass Alpine instance to createStore and createData @ryanmitchell (#267)
```

--------------------------------

### New: Move collection webhook and job

Source: https://statamic-shopify-docs.vercel.app/releases

This update moves the collection create, update, and delete functionality to its own dedicated webhook and job. This refactoring improves modularity and maintainability.

```php
Move collection create/update/delete to its own webhook and job @ryanmitchell (#229)
```

--------------------------------

### Output Shopify Tokens

Source: https://statamic-shopify-docs.vercel.app/frontend/tags

Outputs the Site URL and Storefront Token, binding them to the window for use with the JS SDK. Allows specifying a custom storefront URL in the config.

```Statamic Tag
{{ shopify:tokens }}
```

```HTML
<script>
  window.shopifyConfig = { url: 'your-site.myshopify.com', token: 'storefront-token' }
</script>
```

--------------------------------

### Statamic Shopify Customer Update Webhook

Source: https://statamic-shopify-docs.vercel.app/CMS/customers

Set up a webhook for customer updates in Shopify to transmit updated data to Statamic and refresh customer information. Ensure your Shopify app has 'customer read' and 'customer write' permissions.

```Bash
https://YOURSITE/!/shopify/webhook/customer/update
```

--------------------------------

### Statamic Shopify v6.2.0 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details new features and fixes in version 6.2.0 of the Statamic Shopify integration. New features include applying price hooks across products and variants. Fixes include enabling variants fieldtype for database-stored entries. References GitHub pull requests.

```Markdown
##  v6.2.0 7/15/2025
## What's New
  * Apply price hook across products and variants by @daun in https://github.com/statamic-rad-pack/shopify/pull/300


## What's Fixed
  * Enable variants fieldtype for entries stored in database by @daun in https://github.com/statamic-rad-pack/shopify/pull/299

**Full Changelog** : https://github.com/statamic-rad-pack/shopify/compare/v6.1.0...v6.2.0
```

--------------------------------

### New: Update for Statamic Shopify integration

Source: https://statamic-shopify-docs.vercel.app/releases

This update includes new functionality for the Statamic Shopify integration, as detailed in the linked pull request. It likely introduces new features or improvements to existing ones.

```php
https://github.com/statamic-rad-pack/shopify/pull/227 @ryanmitchell (#227)
```

--------------------------------

### Configure Product Collection Origin Behavior

Source: https://statamic-shopify-docs.vercel.app/CMS/multisite

This configuration snippet ensures that the 'Products' collection in Statamic correctly handles multi-site origins. It specifies that propagation should be toggled on and the origin behavior should use the site where the entry was created.

```yaml
collections:
  products:
    propogate: true
    origin_behavior: "use_site_created_in"
```

--------------------------------

### Import Single Shopify Product via CLI

Source: https://statamic-shopify-docs.vercel.app/CMS/importing-data

Fetches a single product from Shopify by its ID using the Artisan command line interface. The product ID can be found in the `product_id` value stored on the content.

```bash
php artisan shopify:import:single ID_HERE
```

--------------------------------

### Hook for Product Price Formatting

Source: https://statamic-shopify-docs.vercel.app/frontend/tags

Provides a hook to modify product prices and currency. Allows custom formatting using PHP's NumberFormatter.

```PHP
\StatamicRadPack\Shopify\Tags\Shopify::hook('product-price', function ($payload, $next) {
    $formatter = new \NumberFormatter(\Statamic\Facades\Site::current()->locale(), \NumberFormatter::CURRENCY);

    $payload->price = $formatter->formatCurrency((float) $payload->price, 'EUR');
    
    return $next($payload);
});
```

--------------------------------

### Statamic Shopify v5.0.5 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details a fix in version 5.0.5 of the Statamic Shopify integration, correcting how the publish status is set on products. References a GitHub pull request.

```Markdown
##  v5.0.5 11/29/2024
## 🐛 Fixed
  * Fix how we set publish status on products @ryanmitchell (#261)
```

--------------------------------

### Custom Metafield Parser for Shopify Data

Source: https://statamic-shopify-docs.vercel.app/CMS/importing-data

A custom PHP class to parse Shopify metafields before they are saved to Statamic. The `execute` method receives an array of metafields and a context string (product or product-variant) and should return an array keyed by the Statamic field handle.

```php
<?php

namespace App\Shopify;

class MyMetafieldParser
{
    /**
     * Parse any metafields
     *
     * @return array
     */
    public function execute(array $metafields, string $context)
    {
        // do something with $metafields
        return ['key' => 'value', 'another_key' => 'another_value'];
    }

}

```

--------------------------------

### Statamic Shopify Customer Orders Tag with Customer ID

Source: https://statamic-shopify-docs.vercel.app/frontend/tags

Shows how to fetch orders for a specific customer using the `customer_id` parameter with the `shopify:customer:orders` tag. This allows targeted retrieval of order data.

```html
{{ shopify:customer:orders customer_id="my_id" }} ... {{ /shopify:customer:orders }}
```

--------------------------------

### Enable Multi-site in Statamic Configuration

Source: https://statamic-shopify-docs.vercel.app/CMS/multisite

This snippet demonstrates how to enable multi-site functionality for Statamic collections and taxonomies by adding specific sites to the configuration. It's crucial for synchronizing Shopify translations across different locales.

```yaml
collections:
  products:
    sites:
      - en
      - fr

taxonomies:
  collections:
    sites:
      - en
      - fr
  product_types:
    sites:
      - en
      - fr
  tags:
    sites:
      - en
      - fr
  vendor:
    sites:
      - en
      - fr
```

--------------------------------

### New: Set default roles and groups from Statamic for users

Source: https://statamic-shopify-docs.vercel.app/releases

This new feature allows default roles and groups from Statamic to be set when creating users. This streamlines user management by automatically assigning appropriate permissions based on Statamic configurations.

```php
Set default roles and groups from Statamic when making users @ryanmitchell (#225)
```

--------------------------------

### Statamic Shopify v5.0.2 Release Notes

Source: https://statamic-shopify-docs.vercel.app/releases

Details a fix in version 5.0.2 of the Statamic Shopify integration, correcting an incorrect variable name on order creation. References a GitHub pull request.

```Markdown
##  v5.0.2 11/14/2024
## 🐛 Fixed
  * Fix incorrect variable name on order create @ryanmitchell (#255)
```
Tokens:
Raw