> ## Documentation Index
> Fetch the complete documentation index at: https://developer.dashsocial.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Localized product feed setup guide

> Set up localized product feeds to display region-specific prices, titles, and availability in your galleries.

A localized product feed allows you to provide alternative values, such as language or currency, for product fields in your default product feed. This way, you can show localized versions of your products to customers in different countries or who speak other languages.

Before importing a localized product peed, please **ensure you have a product feed imported into Dash Social that will act as the default feed**. The default feed contains all of the default versions of your products. Your default feed must also contain an column for the unique identifier (SKU, product ID, etc.) as that will be used to add the localized information to the default products. Please refer to the [Product Feed Setup Guide](https://developer.dashsocial.com/docs/product-feed-setup-guide) to set up your default feed.

Please note that localized product feed does not support XML format.

## Accepted fields

The following fields in the localized product feed are accepted. If your product feed uses different field names than those listed below, please provide the field mapping to your Account Representative to ensure data consistency.

**Required Fields:**

| Field | Type   | Description                                                                                         |
| :---- | :----- | :-------------------------------------------------------------------------------------------------- |
| id    | string | A unique identifier for the product. This ID should match one of the products in your default feed. |

**Optional Fields:**

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Field
      </th>

      <th>
        Type
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        override
      </td>

      <td>
        string
      </td>

      <td>
        The name of the locale, country code, and language code to which the product belongs.

        Using ISO standards for locales/country codes/language codes is recommended but not enforced.

        * *Note:*\* If you do not provide this field in the product feed, you must communicate with your account representative about the country or language code for which each feed is for.

        When using Product Page Gallery, this value can be passed to `data-override` parameter to display the localized product data. See [Product Page Gallery guide](https://developer.dashsocial.com/docs/product-page-gallery) .
      </td>
    </tr>

    <tr>
      <td>
        url
      </td>

      <td>
        string
      </td>

      <td>
        A URL that links to the product.
      </td>
    </tr>

    <tr>
      <td>
        title
      </td>

      <td>
        string
      </td>

      <td>
        The product name
      </td>
    </tr>

    <tr>
      <td>
        image\_url
      </td>

      <td>
        string
      </td>

      <td>
        A URL that links to an image of the product
      </td>
    </tr>

    <tr>
      <td>
        price
      </td>

      <td>
        string/number
      </td>

      <td>
        The price of the product. You can provide a price including the currency symbol/code (e.g., "\$80.99") or a numeric price (e.g., "80.99").

        When providing a price without the currency symbol/code, it is highly recommended that the `currency_code` field also be provided.
      </td>
    </tr>

    <tr>
      <td>
        currency\_code
      </td>

      <td>
        string
      </td>

      <td>
        A 3-letter code specifying the type of currency used for the product's price. The `currency_code` is appended to the price when displayed in the media popup only if the price is numeric (e.g., "5.99"). If the price is non-numeric (e.g., "\$5.99"), then currency\_code will not be appended.

        For example, if the `price` is specified as "5.99" and the `currency_code` is "CAD," the `price` will be displayed as "5.99 CAD" in the media popup.

        If the `price` is specified as "$5.99" with the currency symbol/code and `currency_code` is "CAD", the `price` will show as "$5.99" in the media pop-up.
      </td>
    </tr>

    <tr>
      <td>
        availability
      </td>

      <td>
        string
      </td>

      <td>
        The current availability of the product.

        Acceptable values are: in stock, out of stock, preorder, available for order, discontinued.
      </td>
    </tr>

    <tr>
      <td>
        description
      </td>

      <td>
        string
      </td>

      <td>
        The description of the product.
      </td>
    </tr>
  </tbody>
</Table>

## Example

Here is a short example of how localized product feeds could be set up.

If my company and customer base are in Canada, my default feed should be in English and have prices listed in CAD. Here is an example of what that might look like:

Default Feed:

| id | url                                                                                        | title     | price | currency\_code |
| :- | :----------------------------------------------------------------------------------------- | :-------- | :---- | :------------- |
| 1  | [https://www.dashsocial.com/en/fakeproduct/1](https://www.dashsocial.com/en/fakeproduct/1) | Product 1 | 249   | CAD            |
| 2  | [https://www.dashsocial.com/en/fakeproduct/2](https://www.dashsocial.com/en/fakeproduct/2) | Product 2 | 749   | CAD            |
| 3  | [https://www.dashsocial.com/en/fakeproduct/3](https://www.dashsocial.com/en/fakeproduct/3) | Product 3 | 1249  | CAD            |
| 4  | [https://www.dashsocial.com/en/fakeproduct/4](https://www.dashsocial.com/en/fakeproduct/4) | Product 4 | 2499  | CAD            |

French Feed:

For customers in France, we want to ensure they are directed to the French website and see prices in their native currency, so we create a localized product feed that specifies the French `url`, `price`, and `currency code`.

| id | url                                                                                              | price | currency\_code | override |
| :- | :----------------------------------------------------------------------------------------------- | :---- | :------------- | :------- |
| 1  | [https://www.dashsocial.com/en/fakeproduct/1/fr](https://www.dashsocial.com/en/fakeproduct/1/fr) | 171   | EUR            | FR       |
| 2  | [https://www.dashsocial.com/en/fakeproduct/2/fr](https://www.dashsocial.com/en/fakeproduct/2/fr) | 514   | EUR            | FR       |
| 3  | [https://www.dashsocial.com/en/fakeproduct/3/fr](https://www.dashsocial.com/en/fakeproduct/3/fr) | 858   | EUR            | FR       |
| 4  | [https://www.dashsocial.com/en/fakeproduct/4/fr](https://www.dashsocial.com/en/fakeproduct/4/fr) | 1716  | EUR            | FR       |

United States Feed:

Since English is the primary language for customers in the United States, we do not need to provide separate product links. Still, we want to display the price in USD, so we create a localized product feed that provides `price` and `currency_code`.

| id | price | currency\_code | override |
| :- | :---- | :------------- | :------- |
| 1  | 180   | USD            | US       |
| 2  | 544   | USD            | US       |
| 3  | 907   | USD            | US       |
| 4  | 1815  | USD            | US       |

## Frequently asked questions

**Q: We don't have a default product feed. Is it okay if we only have the localized feed?**

A: In this case, we recommend selecting the most widely used product feed as the default feed and importing the other localized feeds into Dash Social.

**Q: Can I have a product feed with both the default feed and localized feeds?**

A: No, this is not currently supported. Please ensure you have a default product feed imported into Dash Social before importing any localized feeds.

**Q: How do we determine which location the user is visiting from?**

A: This is controlled by whatever localization is present on the website in which the widget code is embedded. If you have different URLs depending on the users location- the code, as an example, could be looking at the country code in the URL, then passing that to our widget.
