---
schema_version: "1"
id: dccf2661ed13236b378cc2c214f461c55cf4d0a1c92e7a354c9626ca20e1b2bd
title: Zone Component
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/commerce-cloud/einstein/guides/einstein-recommendations/zone-component.md
canonical_url: https://developer.salesforce.com/docs/commerce/einstein-api/guide/zone-component.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 806bd66b222c66860efa0215b0bf7691c56c4c579a4d3d984065582cc06ce26f
products:
  - B2C Commerce Einstein API
  - Salesforce APIs
---
# Zone Component

A _zone_ is defined as one recommendation slot. Using zones for recommendations is optional, but zones offer added flexibility. For example, your product details page can have two zones: one for the "You may also like” recommender and another for the "Complete the set" recommender. Using zones, easily switch between recommenders in Einstein Configurator.

Unlike with content slots, implementing recommendations with the Einstein Recommendations API requires some coding to enable switching among recommenders.

**note:** When changing the recommenders for a zone, limit the change to other recommenders within the same recommender type. With this action, avoid the need to change the recommendation anchor.

## Comparison Between API Setup With or Without Zones

|                                       | With Zones                                                                                                                                              | Without Zones                                                                                                                                  |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Changing recommenders for a zone**  | In Einstein Configurator, change the recommender linked to the zone.                                                                                    | Use a code change to update the API call with the new Recommender.                                                                             |
| **API endpoint**                      | [Get zone recommendations](https://developer.salesforce.com/docs/commerce/einstein-api/references/einstein-recommendations?meta=getZoneRecommendations) | [Get recommendations](https://developer.salesforce.com/docs/commerce/einstein-api/references/einstein-recommendations?meta=getRecommendations) |
| **Recommendations endpoint response** | `{recs: [], recoUUID: '', recommenderName: '', displayMessage: ''}`                                                                                     | `{recs: [], recoUUID: ''}`                                                                                                                     |

The activities endpoint is always the same whether you are using zones or not. The `viewReco` and `clickReco` activities always require a `recommenderName` parameter. When using zones, the `recommenderName` parameter in `viewReco` and `clickReco` activities must come from the response of of a request to the Zone Recommendations API.

## How to Set up Zones in Einstein Configurator

After enabling access to the API in the [Einstein Configurator](https://configurator.cquotient.com/), the Site Recommendations tab changes to a menu for site admin users. Using this menu, view and configure Recommenders or Zones.

Site administrators can enable access to zones for other users from the User Management tab by locating and selecting the user, and selecting **Edit Actions** from the menu.

The Recommenders tab is where you set up, edit, and delete recommenders, the same as using the Site Recommendations page without API access configured. The Zones tab is for setting up, editing, and deleting zones.

To create a zone:

1. Select **Zones** from the Site Recommendations menu.
2. Click **+New Zone**.
3. Specify a Zone Name, and provide an optional description of the zone.
   - After it’s saved, the Zone Name can’t be changed.
4. Use the menu to select an available recommender for use in the zone.
   - If you don’t have any recommenders configured, or haven’t decided which recommender to use for a zone, save this step for later. For information about how to create recommenders, see [Commerce Cloud Einstein Product Recommendations](https://help.salesforce.com/s/articleView?id=cc.b2c_einstein_site_recommendations.htm&type=5).

5. Click **Save**.

Create multiple zones for use through the Einstein API.

## How to Use Zone Components Through the Einstein API

After you set up zones in the Einstein Configurator, a developer uses the configured zone name as the `zoneName` path parameter in the zone API request (see `API Specification` - `Endpoints` - `Zone Recommendations`).

The response contains a `recommenderName` that identifies the name of the recommender currently configured for the zone. Pass this value as the `recommenderName` body parameter in subsequent `viewReco` and `clickReco` activity requests.