---
schema_version: "1"
id: 4feeb4d28e2edac1d24c4f1a1fe6f014764df8017f1e8ef4c5f7a7f9cda691b8
title: Multi-Region Feeds
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/commerce/264-0-0/rt_adv_config_data_feeds_manage_multi_region.md
canonical_url: https://help.salesforce.com/s/articleView?id=commerce.rt_adv_config_data_feeds_manage_multi_region.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: cc245c5f75c2ae8b69f0958736ec4cf23f451e0b004ebc0c6ec43ea1255bb052
description: Point of Sale multi-region feeds let merchants with operations in multiple regions run feeds in the master region. Merchants can also configure other regions to perform product searches against the master catalog. By using multi-region feeds, merchants can streamline their operations and ensure that product searches are accurate across all regions. This feature saves time and improves efficiency by centralizing feed management.
products:
  - Commerce
release: "264"
---
# Multi-Region Feeds

Point of Sale multi-region feeds let merchants with operations in multiple regions run feeds in the master region. Merchants can also configure other regions to perform product searches against the master catalog. By using multi-region feeds, merchants can streamline their operations and ensure that product searches are accurate across all regions. This feature saves time and improves efficiency by centralizing feed management.

Get the feed specs required for merchants to create these files. Usually, we will have a full catalog run once a day and delta’s run multiple times. We can support it using delta and full feeds. These feeds can be run manually and also scheduled to run at a fixed interval pulling the file from an FTP location. There is also a CMS configuration involved to run the search from the master region from other regions.

## Feed Specs

CSV, PSV, and TSV are all the file formats supported. Field mapping from CMS can be used to map the merchant-defined columns to the feed specs columns on the CMS. The mapped field definition is provided below for each of the feeds.

**Feed Frequency**

For all feeds mentioned below, the recommended frequency is to run a full load once a month and then load deltas on an ongoing base as per need.

**Pricing Feed**

As the region changes, the local currency changes, causing prices to be different across regions. This feed will provide the product pricing across the region.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small "><colgroup><col> <col> <col> <col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Type</td><td class="slds-cell-wrap" style="vertical-align:top;">Limits</td><td class="slds-cell-wrap" style="vertical-align:top;">Required</td><td class="slds-cell-wrap" style="vertical-align:top;">Example</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">product_id</td><td class="slds-cell-wrap" style="vertical-align:top;">This is the primary product identifier. Max 128 characters. Must match the ID in the Product feed</td><td class="slds-cell-wrap" style="vertical-align:top;">Yes</td><td class="slds-cell-wrap" style="vertical-align:top;">ABC1234</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">region</td><td class="slds-cell-wrap" style="vertical-align:top;">Two characters and must be an <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2" target="_blank"><u>ISO-3166-1 Alpha 2</u></a> country code.</td><td class="slds-cell-wrap" style="vertical-align:top;">Yes</td><td class="slds-cell-wrap" style="vertical-align:top;">US</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">price</td><td class="slds-cell-wrap" style="vertical-align:top;">Number</td><td class="slds-cell-wrap" style="vertical-align:top;">Yes</td><td class="slds-cell-wrap" style="vertical-align:top;">100.00. This is the list price.</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">sales_price</td><td class="slds-cell-wrap" style="vertical-align:top;">Number</td><td class="slds-cell-wrap" style="vertical-align:top;">Optional</td><td class="slds-cell-wrap" style="vertical-align:top;">90.00</td></tr></tbody></table>

Example field mapping:![A screenshot shows an example price feed field mapping.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_adv_config_data_feeds_manage_multi_region_pricing_example.png)

**Sizing Feed**

This feed will provide the product sizes across the region.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small "><colgroup><col> <col> <col> <col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Type</td><td class="slds-cell-wrap" style="vertical-align:top;">Limits</td><td class="slds-cell-wrap" style="vertical-align:top;">Required</td><td class="slds-cell-wrap" style="vertical-align:top;">Example</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">product_id</td><td class="slds-cell-wrap" style="vertical-align:top;">This is the primary product identifier. Max 128 characters. Must match the ID in the Product feed.</td><td class="slds-cell-wrap" style="vertical-align:top;">Yes</td><td class="slds-cell-wrap" style="vertical-align:top;">ABC1234</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">region</td><td class="slds-cell-wrap" style="vertical-align:top;">Two characters and must be an <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2" target="_blank"><u>ISO-3166-1 Alpha 2</u></a> country code.</td><td class="slds-cell-wrap" style="vertical-align:top;">Yes</td><td class="slds-cell-wrap" style="vertical-align:top;">US</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">size</td><td class="slds-cell-wrap" style="vertical-align:top;">Max 128 characters.</td><td class="slds-cell-wrap" style="vertical-align:top;">Yes</td><td class="slds-cell-wrap" style="vertical-align:top;">Large</td></tr></tbody></table>

Example field mapping:![A screenshot shows an example sizing feed field mapping.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_adv_config_data_feeds_manage_multi_region_size_example.png)

**Inventory Feed**

Different regions will have different fulfillment centers causing the inventory to be different across the regions. This file will ingest region-specific inventory.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small "><colgroup><col> <col> <col> <col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Type</td><td class="slds-cell-wrap" style="vertical-align:top;">Limits</td><td class="slds-cell-wrap" style="vertical-align:top;">Required</td><td class="slds-cell-wrap" style="vertical-align:top;">Example</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">product_id</td><td class="slds-cell-wrap" style="vertical-align:top;">This is the primary product identifier. Max 128 characters. Must match the ID in the Product feed.</td><td class="slds-cell-wrap" style="vertical-align:top;">Yes</td><td class="slds-cell-wrap" style="vertical-align:top;">ABC1234</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">region</td><td class="slds-cell-wrap" style="vertical-align:top;">Two characters and must be an <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2" target="_blank"><u>ISO-3166-1 Alpha 2</u></a> country code.</td><td class="slds-cell-wrap" style="vertical-align:top;">Yes</td><td class="slds-cell-wrap" style="vertical-align:top;">US</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">online_inventory</td><td class="slds-cell-wrap" style="vertical-align:top;">Number</td><td class="slds-cell-wrap" style="vertical-align:top;">Yes</td><td class="slds-cell-wrap" style="vertical-align:top;">100</td></tr></tbody></table>

Example field mapping:![A screenshot shows an example inventory feed field mapping.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_adv_config_data_feeds_manage_multi_region_inventory_example.png)

## Field Mapping

Three new field mapping are available in CMS: Pricing, Sizing, and Inventory. Use the field mapping to map the columns specified in the feed specs.

![A screenshot of the CMS shows feed mapping options.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_adv_config_data_feeds_manage_multi_region_field_mapping.png)

## Feed Types

Based on whether we are uploading a full vs a delta product feed. Feeds can be run in two modes. When we ingest the feeds there is no business logic change in the way they are ingested. These feeds are tied to the master product catalog. Full and Delta are two types of feed. This mainly helps in scheduling them to run automatically by having two different schedules for full and delta.

## Uploading Feeds

**Scheduled Upload**

A scheduled feed is run at a fixed interval and loads the file from the FTP location.

A sample scheduled feed is shown below. Click on the + tile and select the appropriate feed type from the dropdown.

![A screenshot chose various scheduled feed uploads.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_adv_config_data_feeds_manage_multi_region_schedules.png)

**Manual Upload**

You can manually upload the file from CMS.

## Feed Pipeline

Running feeds in the pipeline are used to run these feeds in conjunction with other feeds. Usually, you will be looking at running the product feed first, followed by the pricing, sizing, and inventory feed.

This is an example pipeline with Pricing and Product Sizing feed shown:![A screenshot shows an example pipeline with Pricing and Product Sizing feed.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_adv_config_data_feeds_manage_multi_region_feed_source.png)

Navigate to Product and to the search config in the regions where the search has to run from the master region and update the master region.

![A screenshot shows the editor for a search configuration.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_adv_config_data_feeds_manage_multi_region_search_config.png)

## Multi-Region Feed Strategy

This is a recommended feed strategy for merchants with significant volume.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col>
          <col>
        </colgroup>
        <tbody>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Feed</td>

            <td class="slds-cell-wrap" style="vertical-align:top;">Strategy</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Store Feeds</td>

            <td class="slds-cell-wrap" style="vertical-align:top;">
              <ul>
                <li>All stores need to be uploaded in the master region.</li>

                <li>Other countries can have the same file or just stores specific to the region.
                </li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Multi-Region Feeds</td>

            <td class="slds-cell-wrap" style="vertical-align:top;">
              <ul>
                <li>For the Product Feed, all product catalog information must be included with
                  the price for the master region.</li>

                <li>For the Pricing Feed, it must include pricing per country (list price and sale
                  price per region). Then run in the master region with data for all countries
                  including the master region.</li>

                <li>Sizing Feed must be run in the master region with data for all countries.</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Store Inventory Delta will run only in the master region and will serve two
              purposes </td>

            <td class="slds-cell-wrap" style="vertical-align:top;">
              <ul>
                <li>Seed initial data per country (x amount of records multiplied by x amount of
                  stores in the master region); or this can be run incrementally per store during
                  rollout (x amount of records per store) run x amount of stores in the master
                  region with every store before rollout.</li>

                <li>Run daily to overwrite the inventory and store price per store.<ul>
                    <li>Delta Inventory (overwrite mode) is run in the master region only and all
                      fields are mandatory for the product IDs included in the file:<ul>
                        <li>Country Code</li>

                        <li>Store ID</li>

                        <li>Product ID</li>

                        <li>Inventory</li>

                        <li>Store Price</li>

                      </ul>
                    </li>

                  </ul>
                </li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Taxes</td>

            <td class="slds-cell-wrap" style="vertical-align:top;">
              <ul>
                <li>In each country separately</li>

                <li>One-time load per country</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Associates</td>

            <td class="slds-cell-wrap" style="vertical-align:top;">
              <ul>
                <li>API</li>

                <li>In each region separately</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Register Feed</td>

            <td class="slds-cell-wrap" style="vertical-align:top;">Each country separately, store by store during rollout</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Pipeline </td>

            <td class="slds-cell-wrap" style="vertical-align:top;">
              <p>Pipeline to be run in the master region to include:</p>
              <ul>
                <li>Product Feed</li>

                <li>Pricing Feed</li>

                <li>Sizing Feed</li>

                <li>Store Inventory Delta</li>

              </ul>
            </td>

          </tr>
        </tbody>
      </table>

## Known Issues & Restrictions

- As a common feed is used across the regions deleting a product in the master region will delete it from other regions too.
- Ensure values for the master region are also present in the feeds above.
- There always has to be a merchant available in the other region for the search to run against the master region.
- Only one language is supported on the product catalog for all regions.

## Frequently Asked Questions

**Can Multi-Region Feeds Be Managed Through the Product API?**

Our platform supports Multi-Region Feeds, allowing the master region to run the product feed while enabling other countries to inherit the product metadata, with specific pricing and sizing data provided for each country. However, this capability does not extend directly through the Product API.

- For Multi-Region Pricing Updates: Currently, we do not offer a dedicated pricing API. For multi-region operations, pricing updates must be conducted through the CMS feed mechanism, allowing for regional-level adjustments.
- For Single-Region Pricing Updates: In a single-region setup, the Product API can be utilized to update pricing information. However, for multi-region scenarios, the Product API lacks a "region" field in its specifications (as observed in the [Product Management API](https://developer.salesforce.com/docs/commerce/retail-cloud/references/product-management-api?meta=Summary) reference).
- Workaround for Pricing Updates: Given the absence of a pricing API, pricing information must be included within POST and PUT calls when managing product data. If operating with a single instance per region, the Product API can facilitate pricing updates effectively.