> 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/shopify/salesforce-commerce-cloud/getting-started-guide/enable-and-configure-esw-module.md).

# Enable and Configure ESW Module

### Enable and Configure ESW Module

Navigate to **Merchant Tools → Site Preferences → Custom Preferences → ESW General Configuration** to enable the ESW module.

### Cartridge Setup

Navigate to **Merchant Tools → Site Preferences → Custom Preferences → ESW General Configuration**

![Image](/files/d6e90226b82b733ff58f53ce1be1c3b664505204)

Within ESW General Configuration, specify:

* **ESW Module Enabled:** This is a mandatory attribute. It enables or disables the ESW Module at the site level.
* **ESW Allowed Languages:** The highlighted values represent languages to be considered as ESW Allowed Languages.
* **ESW Base Currency:** It sets the default/base currency at the site level.
* **Enable Geo Lookup (optional):** This option enables or disables the geo IP lookup. If the geo lookup is enabled, the shopper’s current location is determined when they access the site for the first time. If disabled, the country selectors are preselected with the first options from the selectors.

The below values will be provided by the ESW integration team.

* **ESW Retailer Brand Code (provided by IE):** This preference indicates the brand code of the current site.
* **ESW Client ID for the Authorization Request:** Indicates the client ID.
* **ESW Client Secret for Authorization Request:** Indicates the client secret.
* **ESW Basic Auth Enabled:** This option enables or disables basic authentication.

{% columns %}
{% column %}
{% hint style="info" %}

#### Sandbox Instance

The storefront uses **basic authentication**. If the storefront is protected, provide the **storefront username and password** for authentication.
{% endhint %}
{% endcolumn %}

{% column %}
{% hint style="info" %}

#### Production Instance

The retailer must provide **basic authentication credentials** to ESW. These credentials are used to configure **order confirmation endpoint basic authentication** on the ESW tenant side.
{% endhint %}
{% endcolumn %}
{% endcolumns %}

![Image](/files/7c5651d44c3c725209d8ea496972d164db578678)

* **ESW Production Client Secret:** For ESW pricing configuration enter the Client Secret for Price Feed authorization request. Navigate to **Merchant Tools > Site Preferences > Custom Preferences > ESW Pricing Configuration**.

![Image](/files/4a5231f1c8be31aec0f861643e7506bc1c610373)


---

# 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/shopify/salesforce-commerce-cloud/getting-started-guide/enable-and-configure-esw-module.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.