Browse by Topic

Adding Your Catalog to Facebook

BigCommerce recommends the Facebook Ads app for advertising your BigCommerce catalog on Facebook. The instructions here are an alternative method of sending your products to Facebook without the need to enable Facebook Shop for your store (required for the Facebook Ads app). To advertise on Facebook, you need a Facebook Business account.

Basically, the process is:

  • Create a custom Facebook Catalog export template.
  • Export your products to a CSV file.
  • Format your CSV file to match Facebook's requirements (details below).
  • Upload your file in Facebook.

Required Facebook Attributes

Below is a list of the attributes required by Facebook for each of the products in your catalog CSV.

Rename the column headers in your BigCommerce-exported CSV file to match the format required by Facebook. For example, you’ll need to change Product Name to title before importing into Facebook.

Download Facebook's Catalog CSV Template to see how it's formatted.

Required Facebook attribute


Limit / Supported values

Equivalent BigCommerce field


Enter a unique ID for the item, such as a SKU. If there are multiple instances of the same ID, these will be ignored.

Max characters: 100

Product Code/SKU; Product ID


The title of the item.

Max character limit: 100

Product Name


A short description describing the item.

Max character limit: 5000

Product Description


The current availability of the item in your store.

Supported values: in stock, available for order, preorder, out of stock, discontinued

Product Availability


The current condition of the item in your store.

Supported values: new, refurbished, used

Product Condition


The cost and currency of the item.

The price is a number followed by the currency code (ISO 4217 standards). Note: BigCommerce does not define the currency code in the exported Price field, but you'll be able to manually select your currency at Facebook when uploading your file.



The URL of the website where you can buy the item.

Must be absolute URL.

Product URL


The URL for the image used in your ad.  

Must be absolute URL. For square (1:1) aspect ratios in the carousel ad format, your image should be 600x600. For single image ads, your image should be at least 1200x630.

Product Image File - 1


You can use unique manufacturer part number (MPN), Global Trade Item Number (GTIN), or brand name for your product. You only need to use one of these values for this column (not all of them).

Supported values for GTIN: UPC, EAN, JAN and ISBN

Max character limit: 70

Brand Name


Items that are variants of a specific product. Provide the same item_group_id for all items that are variants.



*The item_group_id field is only required if you want to be able to dynamically serve ads for specific variants.


Image URLs

Facebook requires image URLs to be absolute. BigCommerce exports these as relative by default, so you’ll need to edit or create a custom export template to export your full, absolute image URLs.

So instead of looking like this:

/i/200/product-front.jpg (relative/bad)

Your exported product image URLs will look like this: (absolute/good)

In your custom export template, click the Products tab, scroll down to the Product Images section, and uncheck the fields for:

  • Product Image ID
  • Product Image Path

Then, check the Product Image URL field and change its name to Product Image File.

Edit your custom template to change Product Image URL to Product Image File

Save your updated template.


Product Page URLs

There is no way to export your product page links as absolute URLs, so some additional formatting using a spreadsheet editor is necessary to append the protocol and domain prefix (ex. to the relative URL (ex. /men/product1.html).

This can be accomplished in most spreadsheet apps using a concatenate function. See your app’s help documentation for more information.

Use the Concatenate function to make your relative URLs absolute.


For Ads, Facebook doesn’t require that you define each of our specific variants. However, in order to serve ads for specific variants of the same product, related variants need to be identified with a common item_group_id attribute.

Variants with a common item_group_id

BigCommerce formats variants and simple products differently in CSV file exports, so some blank fields will need to be filled/copied before uploading to Facebook. For example, BigCommerce doesn’t assign Product Name values to each variant row, so you’ll need to copy Product Name values from the base product to each of its child variant rows.


Uploading Your Catalog

For more detailed instructions, see Create a catalog in Facebook’s business help.

1. In Business Manager, click the menu at the top left, then under Assets, click Catalogs.

2. Click Create Catalog, select E-commerce as the Catalog Type, then click Next.

3. Assign a catalog owner and give it a name, then click Create.

4. Click View Catalog, then Add Products.

5. Under How do you want to upload your data feed, select Upload Once.

6. Click Upload File to select your formatted CSV file from your computer.

7. Select your Default Currency, then click Start Upload.

Once you’ve successfully added your catalog to Facebook, see Ads Manager Basics and the Ads Manager Guide for more information about creating and managing ads on Facebook.

Was this article helpful?