Menu
Feedback
Start here
Tutorials & Solutions
Developers Portal

Known Issues
Support Rules

Frequently Asked Questions
Announcements
Start here
Marketplace
Facebook IntegrationSending products to Facebook
Sending products to Facebook
3 min read

Once your account authentication is complete, sending products to Facebook will become an automatic process. The following data 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 the data. It is worth mentioning 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, an additional step needs to be performed. 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.

ttribute mapping via spreadsheet is optional, but if you choose to do it, it must be done completely. Otherwise, it may lead to integration errors.

Sending attributes to Facebook

If you would like 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.

Filling in the mapping spreadsheet

The second step is to fill in 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 filled in 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: the field related to the color of the products in your VTEX store is labeled Cor. Therefore, you must fill in the column VTEX attribute name with the word Cor.

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

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

For attribute names and reference values, refer to Facebook’s Universal Basic Attributes 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 filled in with the values for your attributes on VTEX.

Example: let's say that one of the values for the gender attribute in your VTEX store is Feminino. Therefore, you should fill in the VTEX attribute value column with the word Feminino.

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

Example: for the value Feminino, 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. How long this will take to be reflected on Facebook will depend on the extent of your catalog.

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