Catalog Setup

To set up dynamic ads, you need a Facebook catalog. A catalog is a container of information about your products and where you can upload your inventory. You can use your catalog in different ways within the Facebook family of apps. In your inventory, each individual product is described using a set of fields, that is utilized differently, depending on how you consume your catalog.

You can create one catalog for different use cases or you can create multiple catalogs, including catalogs for different languages and countries. Use Catalog Manager to create and manage your catalogs.

Before You Start

Before you set up your catalog, we recommend these guidelines:

If you're using Catalog Manager as part of your application, you may be affected by a couple of security-related breaking changes. See Breaking Changes, 1/30/2018, Catalog Permissions.

Recommended Steps

Note: This guide focuses on products and commerce. For other catalog types, see:

Next Steps

Once you have your catalog setup, you can connect your products to different places in Facebook to power product experiences:

  • Dynamic Ads - Feature products in different formats to be served dynamically as personalized ads.

  • Marketplace - Distribute products in Marketplace.

  • Collection Ads — Use them in immersive formats.

  • Instagram Shopping - Feature in Instagram Shopping experiences, such as product tags on Instagram and soon on Instagram Shops.

  • WhatsApp - Feature in conversational commerce in WhatsApp.


Q: What are the current product limits on catalog size?

A: We recommend breaking larger feeds into smaller ones for faster, parallel upload:

  • We currently recommend under 5 million products per feed through the file upload method.
  • Limit of 100 MB per feed file via Business Manager.

Q: What file formats do you accept?

  • File formats accepted are XML and tab delimited CSV, TXT or TSV. Learn more
  • We also accept files that are compressed: zip, gzip and bz2.

Q: My feed is taking too long to upload

  • Ensure that there are no network connectivity issues.
  • Ensure that your product feed follows the restrictions specified above. Learn more
  • To speed up feed upload process, use a compressed feed file. We support zip, gzip and bz2 compression formats.

Q: How do I get Google Merchant Center feed to dynamic ads?

  • Google Merchant Center feeds can be uploaded directly for dynamic ads.
  • Go to the "link" column to make sure it doesn't have Google tracking parameters on it. The parameters may look like this: URL?utm_campaign=GoogleDynRMKT&utm_medium=display.

Note: To reuse a data feed file from another inventory platform, such as Google or Amazon, Facebook's requirements may be different. Check that your data feed is a CSV, TSV, or XML (RSS/ATOM) file, and has the required columns in our specifications. Learn more

Q: How do I troubleshoot my feed upload errors?

  • Verify the upload errors. Products with fatal errors are not uploaded; the rest are uploaded.
  • Verify the product_count in the product catalog after the feed upload has finished. Instructions here
  • The first line in the field is expected to contain the name of the fields.
  • Use the correct delimiter in your feed file. Supported delimiters are TAB (default), PIPE, or TILDE. Ensure the delimiter you use during the upload is the same delimiter as in the feed file.
  • Check the Use quoted fields option if your feed contains quoted fields.

Q: How do I stop a product from running when it is out of stock?

A: When products go out of stock, you need to mark it as "out of stock" in your product catalog. Products marked "out of stock" automatically stop serving. Scheduling and fetching the product catalog frequently helps you maintain your stock information easily. See the availability field in Supported Fields.

Q: I'm unable to choose or see a product catalog that my team uploaded.

A: Go to Business Manager and make sure the user/account has Product Catalog Admin permissions.

Q: What's the difference between product set and product group?

A: A product set is a collection of product items and product groups within a product catalog defined by a name and a filter or rule that's evaluated dynamically. For example, someone can create a product set with "all things where the brand is Nike and the price is greater than USD 50".

A product group describes a collection of variants of a product item. For example, a black iPhone 6 16 GB has the same product group as a white iPhone 6 16 GB, but they have different product items. A product item can have zero (0) or one (1) product group (product groups are optional).

Q: Can a product appear in multiple product sets?

A: Yes, a product can appear in multiple product sets.

Q: Is the exclusion for Purchase events done at the product group level or product set level?

A: The exclusion for Purchase events is done at the product group level if it is available; otherwise, at the product level.