Menu
Feedback
Start here
Tutorials


Start here
Facebook Integration
Sending products to Facebook
4 min read

Once your account authentication is complete, sending products to Facebook will become an automatic process. The following information will be submitted:

  • Product display name
  • Image
  • Category
  • Price
  • Currency
  • Description
  • Brand
  • Product condition
  • Availability

The update is automatic and will be performed whenever changes are made to any of details. It's important to note that the value for “currency” is defined in the trade policy, and that “availability” refers only to whether there are products available or not, because there is no inventory control. For more information, see How inventory availability works on the product page.

If you want to send product attributes to Facebook, you need to complete an additional step. Attributes are product specifications, i.e., properties that can be added either for products or SKUs.

The additional step is mapping product specifications. Mapping allows matching the attributes from your VTEX store with the standards adopted by Facebook.

Attribute mapping via spreadsheet is optional, but if you choose to do it, you must follow all the steps in the article. Otherwise, it may lead to integration errors.

Sending attributes to Facebook

If you want to send your product attributes to Facebook, please follow the steps below:

  1. Download the mapping spreadsheet template.
  2. Fill in the mapping spreadsheet.
  3. Upload the mapping spreadsheet.

Downloading the mapping spreadsheet

Spreadsheet mapping allows you to match the attributes of your products on the VTEX platform with the standards used by Facebook.

The first step in mapping is to download the file Facebook Mapping Spreadsheet.xlsx.

Completing the mapping spreadsheet

The second step is to complete the downloaded file. The spreadsheet consists of a single tab with five columns.

The Facebook mapping spreadsheet is case-sensitive.

  • First column, ID Category: must be complete with the identification number of the product category on the VTEX platform. You can find the ID of a category in the Admin, in Products > Catalog > Categories. The category ID is the number to the left of the category name.
  • Second column, VTEX attribute name: must contain the name of the attribute on the VTEX platform.

Example: if field related to the color of the products in your VTEX store is labeled Clr. Therefore, you must complete the column VTEX attribute name with the word Clr.

  • Third column, Facebook attribute name: must be populated with the corresponding term used by Facebook.

Example: the match for the Clr attribute on Facebook is Color.

For attribute names and reference values, check the Universal Basic Attributes Facebook documentation. If there is no match for an attribute or value, populate the Facebook attribute name column with the same term used on VTEX.

Fourth column, VTEX attribute value: should be completed with the values for your VTEX attributes.

Example: if one of the values for the gender attribute in your VTEX store is Women, you should complete the VTEX attribute value column with the word Women.

  • Fifth column, Facebook attribute value: should contain the terms used for attribute values on Facebook.

Example: for the value Women, the corresponding term on Facebook is female.

Here is an example of a completed spreadsheet:

CategoryIdVTEX attribute nameFacebook attribute nameVTEX attribute valueFacebook attribute value
23ColorsColorYellowYellow
23SizeSizeSmallP
23SizeSizeLargeG
23GenderGenderFemalefemale

Uploading the mapping spreadsheet

The third and final step to complete the mapping is to upload the completed spreadsheet. To do this, follow the steps below:

  1. Access the Admin.
  2. In the Marketplace module, click Marketplace and Integrations.
  3. Search for Facebook in the search bar.
  4. Click Edit
  5. Choose the Category Mapping option.
  6. Click on Choose a File.
  7. Select the completed mapping spreadsheet.
  8. Click on Upload File.

Once this is done, the mapping of your product categories and attributes will be completed. The time this takes to be reflected on Facebook depends on the extent of your catalog.

Using custom labels

In addition to basic product information, you can send custom labels to Facebook Business Manager. This allows you to classify offers based on your own criteria, such as campaign promotions, seasonal events, margins, or target audience.

Custom labels are useful for:

  • Grouping products by specific campaigns (like Black Friday, Free shipping, etc.)
  • Creating reports based on product groups that have similar behavior.

Setup

You need to create custom labels on Facebook Business Manager. After creating them, follow the Adding product specifications or fields tutorial to link them to a specific offer using product specifications.

Add the following value when creating the new product specification field:

FieldValue
Specification field namefacebook-labels
Field typeRadio

After creating the specification, you need to link it to your offers by following the instructions below:

  1. In the VTEX Admin, go to Catalog > Products and SKUs or type Products and SKUs in the search bar at the top of the page.
  2. In the product row, click the vertical ellipsis icon and then Edit product.
  3. Go to the Product tab.
  4. Complete the facebook-labels field with the desired values separated by semicolons ;.
  5. Click Save.

An offer can have a maximum of five linked labels.

Contributors
1
Photo of the contributor
+ 1 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
4. Configuring the connector
« Previous
1. TikTok for Business
Next »
Contributors
1
Photo of the contributor
+ 1 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX Community
Join our community
Request VTEX support
For personalized assistance, contact our experts
Open a support ticket
GitHubDeveloper PortalCommunityFeedback