Skip to main content

CookieSessionStorage

The CookieSessionStorage component is the default session storage mechanism for Hydrogen.

Example code​

hydrogen.config.js
import {defineConfig, CookieSessionStorage} from '@shopify/hydrogen/config';

export default defineConfig({
  shopify: {/*...*/},
  session: CookieSessionStorage('__session', {
    path: '/',
    httpOnly: true,
    secure: process.env.NODE_ENV === 'production',
    sameSite: 'strict',
    maxAge: 60 * 60 * 24 * 30,
  }),
});

Props​

PropTypeDescription
cookieNamestringThe name of the cookie stored in the browser.
cookieOptions?CookieOptionsAn optional object to configure how the cookie is persisted in the browser.

Component type​

The CookieSessionStorage component is a server component that renders inside App.server.jsx. For more information about component types, refer to React Server Components.

Considerations​

Don't use CookieSessionStorage if you expect to have more than 4kb of data within sessions.