Maintain Shopper Sessions Across Subdomains in Your Composable Storefront

Configure a shared parent cookie domain to keep shoppers logged-in with their baskets preserved when navigating between different subdomains. The domain-level cookie applies to storefronts that use multiple subdomains, such as www. and shop. on the example.com domain. It also applies to hybrid PWA Kit and SFRA storefronts that serve different paths under one parent domain. Without this configuration, shoppers lose their login status and shopping baskets when crossing subdomain boundaries. The loss of login status happens because browsers isolate cookies to individual hosts by default. Prevent frustration and abandoned carts by setting up domain-level cookies.

Prerequisite 

PWA Kit version 3.19 or later. See the pwa-kit GitHub repository.

Configure a Shared Parent Cookie domain 
  1. In Business Manager, go to Merchant Tools > Your Site > Site Preferences > Hybrid Auth Settings.
  2. Under Site Settings, set the domain scope for hybrid auth cookies. To scope cookies to the current host only, enter 0 for the cookie domain level. To share cookies across across subdomains, set the level to 2. Hybrid auth cookie domain scope setting

See Also 

Node 20 Deprecation

Node 20 has an end-of-life date of April 30, 2026. We strongly recommend that you update your production projects to Node 22 or Node 24 by upgrading to the latest minor version of PWA Kit 3.x. See full details on Node support dates and upgrade steps in Upgrade Node Version.

Announcements
Choose Your B2C Commerce Storefront Type
B2C Commerce
SCAPI
Storefront Next
Composable Storefront
Composable Storefront Overview
Quick Start
Deploy Your Code
Skills for Success
Introduction to Composable Storefront
Use Composable Storefront in a Hybrid Implementation
PWA Kit Framework
Performance Guide for Composable Storefronts
Get Set Up
Build Your Site
Build B2C Storefronts Faster with the B2C DX MCP Server
Accelerate PWA Kit Development with the PWA Kit MCP Server (Developer Preview)
Integrate Page Designer with PWA Kit
Environment Variables
Template Extensibility
Provide Orders from Salesforce Order Management
Implement Password Reset
Implement Passwordless Login
Implement Social Login
Personalize with Cookies
Use HttpOnly Session Cookies for Improved Storefront Security
Maintain Shopper Sessions Across Subdomains in Your Composable Storefront
Personalize with Shopper Context
Boost In-Store Sales with Store Locator
Expand Shopping Options with In-Store Pickup
Ship Products to Multiple Addresses and Stores in a Single Order
Configure Address Autocomplete for Your B2C Commerce PWA Kit Storefronts
Configure One-Click Checkout for Your B2C Commerce Composable Storefronts
Protect Privacy with a Tracking Consent Banner
Limit Access to a Storefront Under Development
Maximize Your Cache Hit Ratio
Improve SEO with a Sitemap
Enable Your Merchant Team
Test, Launch, and Monitor
Maintain
Composable Storefront Specifications
Storefront Reference Architecture (SFRA)
Commerce Apps ISV Developer Guide
B2C Commerce Solutions
B2C Commerce Release Notes
B2C Commerce Reference Information
Ask the Community