Product Feed ID

The product feed is used as the primary source for updating product catalogs on Facebook, and fetched by Facebook periodically according to the configured interval. You should store the product feed ID, and use it to get upload status, errors, and to change upload schedule.

Catalog Batch API Support

Batch API is a great way to update items more then once an hour. You can update up to 5,000 items with up to 100 calls per hour. To create inventory, use the Feed API, Reference, Dynamic Ads or Feed API, Reference, Commerce Platform.

Scheduled Feeds

Scheduled feeds don't support uploads more frequently than once per hour. If you need to update inventory faster, use the Direct Upload API or Batch API.

Schedule replace feed outside of working hours to avoid product update lag.

Seller Onboarding

Set up your catalog during seller onboarding and upload or configure your products using the Product Feed API. Reuse ads catalog to get benefits of using offsite and onsite signals.


  • The id, title, description, price, inventory, link, image_link fields should be visible.

  • The gtin or mpn plus brand fields should be visible.

  • The rich_text_description (preferably) or description fields should be visible, well formatted (no extra spacing, punctuation is correct), and informative (may contain information on item size, volume, origin, and so on).

  • Ensure that the variant field's (such as size or color) value is visible for every product variant sharing a common item_group_id, even those that are out of stock.


  • Ensure that the description does not contain HTML tags or character entities.

  • Ensure that the price is in the correct format and currency.

  • Ensure that the sale_price is provided for items on sale.

  • Ensure that the google_product_category is (at minimum) 2 levels deep, alternatively use commerce_tax_category.

  • Ensure that product variants are sharing the same item_group_id.

  • Ensure that the availability and inventory fields are populated according to a agreed upon strategy.

  • Use additional_image_link to add more product images (up to 10).

  • Make sure that product images satisfy catalog requirements.

  • Make sure that product titles satisfy catalog requirements.

  • Make sure that product descriptions satisfy catalog requirements.


  • Ensure that the link URL responds with HTTP 200 OK.

  • Check the product catalog diagnostics tool for the following information each time you upload a new product feed:

    • Fix all upload errors, a product marked with an error will be rejected from your catalog.
    • Verify all warnings, some of warnings may affect product ingestion and prevent your product from being tagged or available for purchase.
    • Ensure that each product complies with the Facebook Commerce Policies. Product that violate the policy will be marked as rejected and will not be available for tagging or purchase.

Select Products for Ads or Commerce

For products that are used for dynamic ads, create product sets which include only relevant products.

For Facebook Marketplace or Instagram Shopping with Checkout add inventory only for checkout products. Products that do not have an inventory set will not appear on checkout surfaces.

Localized Catalog Setup

When using localized catalog make sure that the main catalog feed has US as default country and the main currency is USD, otherwise the checkout would not work.