--- title: Shop Configuration description: "Choose optional storefront features and set your store's identity and locale." url: "https://shop-docs.labs.vercel.dev/docs/reference/shop-config" docs_index: /llms.txt lastUpdated: 2026-10-08 type: reference --- > For an index of all documentation, see [/llms.txt](/llms.txt). Edit `lib/config/index.ts` to choose which features your storefront offers. Keep credentials in [environment variables](/docs/reference/env-vars) and manage catalog content in Shopify. Customer accounts, Shop Agent, analytics, bot protection, WebMCP, and Shopify redirects on missing pages are **disabled by default**. Enable only the features you intend to use and complete their setup before deploying. ## Settings | Setting | Default | Behavior | | ------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | `agent.isEnabled` | `false` | Enables Shop Agent for product discovery, store questions, and cart updates. | | `analytics.vercel.isEnabled` | `false` | Enables Vercel Web Analytics. | | `analytics.speedInsights.isEnabled` | `false` | Enables Vercel Speed Insights. | | `analytics.shopify.isEnabled` | `false` | Enables Shopify analytics and its consent integration. | | `analytics.shopify.consent.isEnabled` | `false` | Enables Shopify consent without enabling Shopify analytics. | | `analytics.shopify.consent.mode` | `default-banner` | Chooses how shoppers give consent; see below. | | `auth.isEnabled` | `false` | Enables customer sign-in and account pages. | | `botid.isEnabled` | `false` | Enables Vercel BotID checks for Shop Agent requests. | | `botid.checkLevel` | `basic` | Chooses `basic` or `deepAnalysis` bot detection. | | `localization.country` | `"US"` | Sets the country used for Shopify pricing and availability. | | `localization.language` | `"EN"` | Requests Shopify content in this language. | | `localization.locale` | `"en-US"` | Sets display formatting; does not translate interface text or select a currency. | | `pdp.bundles.isEnabled` | `true` | Shows bundle relationships when Shopify provides them. | | `pdp.buyWithShop.isEnabled` | `true` | Shows Buy with Shop. | | `pdp.complementaryProducts.isEnabled` | `true` | Shows complementary products when Shopify provides them. | | `pdp.quantityPicker.isEnabled` | `true` | Shows the product quantity picker. | | `pdp.relatedProducts.isEnabled` | `true` | Shows related products when Shopify provides them. | | `redirects.shopifyNotFound.isEnabled` | `false` | Enables [Shopify redirect lookup](/docs/anatomy/proxy#shopify-redirects-on-missing-pages) when a storefront page is not found. | | `search.isEnabled` | `true` | Shows the header search button and predictive search dialog. | | `shopify.webmcp.isEnabled` | `false` | Registers Shopify catalog and cart tools with WebMCP in supported browsers. | | `site.description` | Template tagline | Summarizes the storefront for AI agents in `/llms.txt` and the home page's Markdown. | | `site.name` | `"Vercel Shop"` | Sets the storefront name. | | `site.url` | Deployment-dependent | Sets the public origin used for canonical URLs, metadata, and discovery links. | ## Before enabling optional features **Shop Agent** requires AI Gateway access in addition to the storefront's Shopify connection. Customer sign-in is not required. Follow [Shop Agent setup](/docs/anatomy/agent), including its privacy and spending safeguards, before enabling public traffic. **Customer accounts** require a Shopify client ID, Shopify client secret, and a separate app-generated session secret in addition to the shop ID required for every build. Follow [Authentication](/docs/anatomy/authentication) to configure those values and register callback URLs before enabling `auth.isEnabled`. **Bot protection** can be enabled separately for Shop Agent on Vercel. Review [BotID pricing](https://vercel.com/docs/botid#pricing) before choosing `deepAnalysis`. It does not make chat history private or cap AI spending. ## Store identity and locale On Vercel, `site.url` uses the project's production domain. Elsewhere it defaults to `http://localhost:3000`; set it to your public storefront origin before deploying. Set the required `NEXT_PUBLIC_SHOPIFY_SHOP_ID` to the numeric shop ID, not the Headless storefront ID. Country and language control the Shopify context. The formatting locale controls how values are displayed. Changing these settings does not translate storefront interface text, and currency comes from Shopify's responses. See [Shopify Markets](/docs/skills/enable-shopify-markets) or [i18n](/docs/skills/enable-i18n) when adding localized storefronts. ## Shopify consent modes Shopify consent loads when Shopify analytics, standalone consent, or WebMCP is enabled. If all three are off, the storefront still loads Shopify cart actions but skips the analytics and consent scripts. These modes apply whenever Shopify consent loads. | Value | Behavior | | ---------------- | -------------------------------------------------------------------------------------------- | | `default-banner` | Uses Shopify's hosted privacy banner where consent is required. | | `custom-banner` | Requires you to provide a consent interface connected to Shopify's Customer Privacy API. | | `no-banner` | Shows no consent interface. Where consent is required, analytics events cannot be delivered. | Only expose the public Storefront API token to the browser. Never use a private token for Shopify analytics or consent requests. ## Related configuration Manage navigation and footer menus with [Shopify Menus](/docs/skills/enable-shopify-menus). [WebMCP](/docs/anatomy/webmcp) is independent of Shopify analytics. Enabling one does not enable the other. --- 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)