Skip to main content


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

Example code

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,


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.


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