Catalog Setup for Localized Instagram Shopping

This product is currently in Alpha testing and only available to selected Alpha testers.

IMPORTANT document to review: our feeds example can be found here - including a tab for the language feed, another for the country feed and the last one containing the locales supported.

Why Localized Instagram Shopping?

Currently, when tagging products on Instagram shopping posts, the same product information will be shown in a single post to your global Instagram audience, regardless of where they are or the language they speak. This, for example, means that the same price is shown to your audience everywhere and people in France may see German on shopping tags.

We understand this has been challenging for some clients, so we are testing a new catalog set-up that will allow businesses to serve localized product information to the users based on their location/ country or language. For example, from a single Instagram post, being able to show French / Euros to people in France and English / USD to people in the US.

Get Started with your Localized Catalog

Just follow these steps to get started:

Accept the Terms of Service (standard beta agreement)
Please work with your Sales contact to confirm you have read our policy and signed the agreement.
Create a Feed for your primary catalog in Business Manager
Create a new catalog for this test by setting up a feed with scheduled fetches as you would for Dynamic Ads. For a refresher, information can be found in the Resource section below. Please also read the Limitations & Important Details section on why this is required.
Give our Business Manager access to your catalog
This will allow us to help you setup your catalog with the country and language feeds. For information on how to do this, see the Resources section below.
Set up your country and language feeds
You will need to create two new feeds to be used with your primary catalog - one for different product information based on the language, and one for different product information based on the country. Once you have made it available on your server (https/sftp), we will help link them to your catalog.
Double check with us that your catalog has been set up correctly
We will help you check that all products have been overridden correctly
Make your first localized post on Instagram Shopping!

Please note that in this early version of the product, you will need to ask someone with a different language setting or location to verify whether the post has been accurately localized.

Important Product Details & Limitations

  1. We recommend you localize information as below:

    • Language Feed: title, description
    • Country Feed: price, sale_price, link
  2. At this time, you can only localize information for country OR language, not country AND language. This means, you won't be able to input two different versions of English for UK and the US.

  3. We require you create a new catalog for this test and ensure the localized information is inputted completely and correctly for every product in your new catalog. If this is done incorrectly, your audience may have an inconsistent experience on Instagram shopping (e.g. 3 out of 4 tags have localized information). This is because Instagram shopping will display product information from your primary feed vs. the language / country feed if the localized information is not available.


Languages allowed: locales supported can be found on the third tab of the documentation mentioned above. Please note that a couple end with _XX: en_XX, es_XX, fr_XX, nl_XX,no_XX, pt_XX, tl_XX. Make sure you respect the case of the strings too (XX is uppercase)

Countries allowed: we are supporting 2 letters ISO codes for countries, but please not that you will need to use GB and NOT UK in your feed.

How will my Instagram Shopping post be displayed?

When you create a post and tag products from your catalog

Your process for creating an Instagram post will not change. When you tag products, you will see product information in your own country / locale, but your audience will view products with localized information.

To validate whether the tags have been shown correctly, you will need to have someone located in another country or with a different phone setting to view the post.

How the instagram shopping post will appear to your audience

Your audience will see the product information localized according to their phone or app language settings and their country based on location. For example:

Country/LangagePost details

For a default catalog in French and Euros

Somebody in UK with settings in English will see:

Set Up Your Feeds via the API

Once you have created the country and language feeds, and made them available on your server, you will need to link them to your catalog following the same API calls presented in our documentation, with the override_type parameter:

Uploading the language feed

curl \
  -F 'name=Language feed' \
  -F 'schedule={ 
    "interval": "DAILY", 
    "url": "http:\/\/\/sample_language_feed.tsv",
    "hour": 22
  }' \
  -F 'override_type=language'
  -F 'access_token=<ACCESS_TOKEN>' \<YOUR_PRODUCT_CATALOG_ID>/product_feeds

Uploading the country feed

curl \
  -F 'name=Country Feed' \
  -F 'schedule={ 
    "interval": "DAILY", 
    "url": "http:\/\/\/sample_country_feed.tsv",
    "hour": 22
  }' \
  -F 'override_type=country'
  -F 'access_token=<ACCESS_TOKEN>' \<YOUR_PRODUCT_CATALOG_ID>/product_feeds


Represents the location we can retrieve the feed file from


Represents the frequency at which we fetch from the feed file


Represents which hour of the day (24hr clock) we fetch the feed

For more options about scheduling of fetches, see our main documentation