> For the complete documentation index, see [llms.txt](https://developer.esw.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.esw.com/adobe-commerce-magento/integration/esw-storefront-cookies.md).

# ESW Storefront Cookies

The ESW extension uses a small set of browser cookies to control market selection and storefront widget behavior.

If you implement market selection or GeoIP redirects outside the ESW frontend widgets, keep these cookie values aligned with the active shopper country and currency.

### Cookie reference

#### `esw-location`

Stores the shopper country used by the ESW extension.

If the cookie is missing, the extension falls back to the Adobe Commerce default country.

Example:

`esw-location={"country":{"iso_code":"US"}}`

This cookie is also used in cache variation flows for localized pricing. For more details, see [Calculated Pricing Cache Setup](/adobe-commerce-magento/integration/calculated-pricing-cache-setup.md).

#### `esw-currency`

Stores the active currency used by ESW storefront selectors and related frontend behavior.

Example:

`esw-currency=USD`

If your store uses calculated pricing, make sure the currency value stays aligned with the configured [Pricing Model](/adobe-commerce-magento/adobe-commerce-extension-integration/getting-started/pricing-model.md).

#### `esw-geoip`

Controls whether GeoIP should be used to detect the shopper country.

Use this when GeoIP-based market selection is enabled in the storefront experience.

#### `esw-landing-played`

Tracks whether the ESW welcome mat has already been shown to the shopper.

This prevents the landing experience from being shown repeatedly in the same browser session or state.

#### `esw-shopper-access-token`

Stores the shopper authorization token used for [Stored Cards](/adobe-commerce-magento/additional-features/stored-cards.md).

This cookie is only present when stored cards are enabled and the shopper is eligible for that flow.

### Expected result

When these cookies are set correctly:

* the storefront resolves the correct ESW market
* country and currency selectors stay in sync
* widget behavior stays consistent across visits
* stored card flows can identify eligible logged-in shoppers


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.esw.com/adobe-commerce-magento/integration/esw-storefront-cookies.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.