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.


## What 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

## Requirements



- You've completed the [Getting started with the Storefront API](/docs/storefronts/headless/building-with-the-storefront-api/getting-started) guide.




## Add 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**.

1. On the **Storefronts** page, click **Add storefront**.

## View custom storefronts

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

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

## Edit storefront names

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

1. On the **Storefronts** page, select the storefront to rename.

1. Beside **Storefront name**, click **Edit**.

1. Type the new name for the storefront.

1. Click **Save**.

## Rotate 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**.

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

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

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

1. Beside the old private access token, click **Delete**.

1. When prompted, click **Delete token**.

## Request 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**.

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

1. In the **Storefront API permissions** card, click **Edit**.

1. Select or deselect permissions for the store.

1. Click **Save**.

## Order attribution

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


1. From your Shopify admin, click **Orders**.

1. 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](/docs/storefronts/headless/building-with-the-storefront-api/cart/manage).

## Delete 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**.

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

1. In the **Delete storefront** card, click **Delete storefront**.

1. Click **Delete storefront**

## Next steps

- Learn more about [Storefront API authorization and rate limiting](/docs/api/usage/authentication).
- Learn more about [Storefront API access tokens](/docs/api/usage/access-scopes#unauthenticated-access-scopes).
- Learn how to [publish products](https://help.shopify.com/en/manual/products/add-update-products#including-and-excluding-products-from-your-sales-channels) and [schedule product publishing](/docs/apps/build/sales-channels/scheduled-product-publishing) with the Headless channel.
- Learn how to view [analytics](https://help.shopify.com/manual/online-sales-channels#view-sales-channel-dashboards-in-your-shopify-home) and [reporting sales by channel](https://help.shopify.com/manual/reports-and-analytics/shopify-reports/using-reports/filter-and-edit#filter-your-reports) with the Headless channel.