Shop Configuration
Edit lib/config/index.ts to choose which features your storefront offers. Keep credentials in environment variables 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 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, 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 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 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 or 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.
WebMCP is independent of Shopify analytics. Enabling one does not enable the other.