A data feed is a spreadsheet file that you upload to your catalog to add and update items in bulk. When you create a data feed, make sure to follow our specifications to avoid errors.

Note: If you want to reuse a data feed from another inventory platform like Google, make sure to check Facebook's specifications as they may be slightly different.

Required fields for ecommerce (products)

Each field (column) in your data feed represents information about your items, like description and price. Some fields are required and others are optional. To avoid item errors, make sure to include all the required fields exactly as they appear in our specifications. Note that field names must be in US English. Check which fields you need for your inventory type below.

If you're an ecommerce advertiser or seller, you can connect your catalog to ads and sales channels to advertise and sell your items. Select a channel to see required fields at a glance:

Supported file formats and size limits

• Your data feed file must be in CSV, TSV or XML (RSS/ATOM) format. If you create your file in a spreadsheet program like Excel, make sure to save it in one of these formats. Note: You can now also select Google Sheets during feed upload and we'll convert your shareable link from Google to an accepted format automatically.
• The size limit for a one-time file upload is 100MB. The size limit for scheduled feed uploads (from a file hosting website) is 8GB.
• We also support compressed files in ZIP and GZIP formats up to 30GB as long as they are in CSV, TSV or XML format when uncompressed.
• You can compare formats and view some example files below. To download a template you can use for your data feed, see our guide to creating a data feed.

Specifications for scheduled feed uploads

• To schedule feed uploads hourly, daily or weekly, you need to save your file on a file hosting website like Dropbox and provide the URL.
• Your URL must begin with http, https, ftp or sftp.
• Your URL must link to your downloadable data feed file in CSV, TSV or XML format. The URL can't go to your website's product page, Facebook Page or somewhere else. To test the URL, copy and paste it your browser to make sure it opens your file.
• If your file is password protected, provide the username and password.

Note: You can now also select Google Sheets for scheduled feed uploads. We'll convert your shareable link from Google to an accepted format automatically.

Checking for errors

• To check your file for errors before you upload it, copy and paste a sample of your feed into the feed debug tool and select Validate.
• After you upload your data feed, check Issues under the Catalog tab to see any errors with your data feed and learn how to fix them. Learn more about troubleshooting catalog issues. You can also check our data feed troubleshooting guide to fix the most common data feed errors.