---
title: Storefront API Permissions
description: Shopify Storefront API scopes required by Vercel Shop and its optional skills.
type: reference
prerequisites:
  - /docs/getting-started
---

# Storefront API Permissions



After [Getting Started](/docs/getting-started), open **Settings → Apps and sales channels → Headless → your storefront** in Shopify admin and grant these Storefront API permissions to the token.

## Required

| Scope                                      | Enables                                           |
| ------------------------------------------ | ------------------------------------------------- |
| `unauthenticated_read_product_listings`    | Product pages, search, and recommendations        |
| `unauthenticated_read_product_inventory`   | Product and collection availability               |
| `unauthenticated_read_collection_listings` | Collection pages and navigation                   |
| `unauthenticated_write_checkouts`          | Cart operations and checkout                      |
| `unauthenticated_read_content`             | Pages, policies, blogs, articles, and metaobjects |

## Optional

Grant optional scopes only when you enable the related feature.

| Scope                                | Required by                                    |
| ------------------------------------ | ---------------------------------------------- |
| `unauthenticated_read_customer_tags` | [Authentication](/docs/anatomy/authentication) |

See [Environment Variables](/docs/reference/env-vars) for token configuration and [Storefront API](/docs/reference/storefront-api) for query validation and runtime behavior.


---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)