--- title: Manage the Headless channel description: >- Learn how to manage the Headless channel, by rotating private access tokens, setting storefront permissions, and creating additional storefronts. source_url: html: >- https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels md: >- https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md --- ExpandOn this page * [What you'll learn](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#what-youll-learn) * [Requirements](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#requirements) * [Add storefronts](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#add-storefronts) * [View custom storefronts](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#view-custom-storefronts) * [Edit storefront names](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#edit-storefront-names) * [Rotate private access tokens](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#rotate-private-access-tokens) * [Request storefront permissions](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#request-storefront-permissions) * [Order attribution](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#order-attribution) * [Delete storefronts](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#delete-storefronts) * [Next steps](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#next-steps) # 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. *** ## 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](https://shopify.dev/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**. 2. On the **Storefronts** page, click **Add storefront**. *** ## View custom storefronts 1. From your Shopify admin, under **Sales channels**, click **Headless**. 2. On the **Storefronts** page, optionally select a storefront to view it. *** ## Edit 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**. *** ## 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**. 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**. *** ## 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**. 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**. *** ## 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**. 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](https://shopify.dev/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**. 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** *** ## Next steps * Learn more about [Storefront API authorization and rate limiting](https://shopify.dev/docs/api/usage/authentication). * Learn more about [Storefront API access tokens](https://shopify.dev/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](https://shopify.dev/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. *** * [What you'll learn](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#what-youll-learn) * [Requirements](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#requirements) * [Add storefronts](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#add-storefronts) * [View custom storefronts](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#view-custom-storefronts) * [Edit storefront names](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#edit-storefront-names) * [Rotate private access tokens](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#rotate-private-access-tokens) * [Request storefront permissions](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#request-storefront-permissions) * [Order attribution](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#order-attribution) * [Delete storefronts](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#delete-storefronts) * [Next steps](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels.md#next-steps)