Skip to main content

Manage the Headless channel

You can manage the Headless channel by creating new storefronts, rotating your private access tokens, editing store names, managing storefront permissions, order attribution, and more. The Headless channel gives you all of Shopify's channel features, such as product publishing, scheduled product publishing, analytics, and reporting sales by channel.

Note

The following instructions assume that you've pinned the Headless channel in your Shopify admin. If you haven't, then you can access the channel using the Search field.

Anchor to What you'll learnWhat you'll learn

You'll learn how to do the following tasks:

  • Add a custom storefront using the Headless channel

  • View a list of your custom storefronts

  • Edit storefront names

  • Rotate private access tokens

  • Edit storefront permissions

  • Order attribution

  • Delete storefronts

Anchor to RequirementsRequirements

Anchor to Add storefrontsAdd storefronts

You can have a maximum of 100 active storefronts and access tokens per shop.

  1. From your Shopify admin, under Sales channels, click Headless.

  2. On the Storefronts page, click Add storefront.

Anchor to View custom storefrontsView custom storefronts

  1. From your Shopify admin, under Sales channels, click Headless.

  2. On the Storefronts page, optionally select a storefront to view it.

Anchor to Edit storefront namesEdit storefront names

  1. From your Shopify admin, under Sales channels, click Headless.

  2. On the Storefronts page, select the storefront to rename.

  3. Beside Storefront name, click Edit.

  4. Type the new name for the storefront.

  5. Click Save.

Anchor to Rotate private access tokensRotate private access tokens

Caution

After you delete your old private access token, you need to update any applications or scripts to use the new token, or else you won't be able to access the Storefront API. Deleting a private access token can't be undone.

  1. From your Shopify admin, under Sales channels, click Headless.

  2. On the Storefronts page, select the storefront to rotate the access tokens for.

  3. In the Storefront API tokens card, under Rotate private access token, click Generate new token.

  4. Update any applications or scripts to use the new token. The old token remains valid until you delete it.

  5. Beside the old private access token, click Delete.

  6. When prompted, click Delete token.

Anchor to Request storefront permissionsRequest storefront permissions

Permissions control what Storefront API data custom storefronts can display in your Shopify store. When you install the channel, a default set of permissions is created for you. You can edit these.

Caution

Both Storefront and Admin API permissions are shared across all storefronts.

  1. From your Shopify admin, under Sales channels, click Headless.

  2. On the Storefronts page, select a storefront to edit permissions for.

  3. In the Storefront API permissions card, click Edit.

  4. Select or deselect permissions for the store.

  5. Click Save.

Anchor to Order attributionOrder attribution

Order attribution is at the channel level, and a Headless storefront is treated as a channel.

  1. From your Shopify admin, click Orders.

  2. In the Channel column, sales attributed to the Headless channel are displayed as the name of the Storefront through which the sale was made.

Learn how to create an order.

Anchor to Delete storefrontsDelete storefronts

Caution

Deleting a storefront invalidates its Storefront API tokens. This action can't be undone.

  1. From your Shopify admin, under Sales channels, click Headless.

  2. On the Storefronts page, select a storefront to edit permissions for.

  3. In the Delete storefront card, click Delete storefront.

  4. Click Delete storefront

Anchor to Next stepsNext steps

Was this page helpful?