{"section":"tracks","requestedLocale":"en","requestedSlug":"sending-products-to-facebook","locale":"en","slug":"sending-products-to-facebook","path":"docs/en/tracks/marketplace/facebook-integration/sending-products-to-facebook.md","branch":"main","content":"Once your account authentication is complete, sending products to Facebook will become an automatic process. The following information will be submitted:\n\n- Product display name\n- Image\n- Category\n- Price\n- Currency\n- Description\n- Brand\n- Product condition\n- Availability\n\nThe 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](/en/docs/tutorials/how-inventory-availability-works-on-the-product-page).\n\nIf you want to send product attributes to Facebook, you need to complete an additional step. Attributes are product [specifications](/en/docs/tracks/specifications-concept-definition), i.e., properties that can be added either for products or SKUs.\n\nThe additional step is mapping product specifications. Mapping allows matching the attributes from your VTEX store with the standards adopted by Facebook.\n\n> ⚠️ 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.\n\n## Sending attributes to Facebook\n\nIf you want to send your product attributes to Facebook, please follow the steps below:\n\n1. [Download the mapping spreadsheet template](#downloading-the-mapping-spreadsheet).\n2. [Fill in the mapping spreadsheet](#filling-in-the-mapping-spreadsheet).\n3. [Upload the mapping spreadsheet](#uploading-the-mapping-spreadsheet).\n\n### Downloading the mapping spreadsheet\n\nSpreadsheet mapping allows you to match the attributes of your products on the VTEX platform with the standards used by Facebook.\n\nThe first step in mapping is to download the file [Facebook Mapping Spreadsheet.xlsx](https://cdn.statically.io/gh/vtexdocs/help-center-content/files-migration-script/docs/en/tracks/marketplace/facebook-integration/Planilha_de_Mapeamento_Facebook.xlsx).\n\n### Completing the mapping spreadsheet\n\nThe second step is to complete the downloaded file. The spreadsheet consists of a single tab with five columns.\n\n> ℹ️ The Facebook mapping spreadsheet is case-sensitive.\n\n- **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.\n- **Second column, _VTEX attribute name_:** must contain the name of the attribute on the VTEX platform.\n> 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_.\n\n- **Third column, _Facebook attribute name_:** must be populated with the corresponding term used by Facebook.\n> Example: the match for the _Clr_ attribute on Facebook is _Color_.\n\n  > ℹ️ For attribute names and reference values, check the [Universal Basic Attributes](https://developers.facebook.com/docs/commerce-platform/catalog/fields?locale=en_US#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.\n\n **Fourth column, _VTEX attribute value_:** should be completed with the values for your VTEX attributes.\n> 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*.\n\n- **Fifth column, _Facebook attribute value:_** should contain the terms used for attribute values on Facebook.\n> Example: for the value _Women_, the corresponding term on Facebook is _female_.\n\nHere is an example of a completed spreadsheet:\n\n| **CategoryId** | **VTEX attribute name** | **Facebook attribute name** | **VTEX attribute value** | **Facebook attribute value** | \n| ---------- | ---------- | ---------- | ---------- | ---------- | \n| 23 | Colors | Color | Yellow | Yellow |\n| 23 | Size | Size | Small | P |\n| 23 | Size | Size | Large | G |\n| 23 | Gender | Gender | Female | female |\n\n### Uploading the mapping spreadsheet\n\nThe third and final step to complete the mapping is to upload the completed spreadsheet. To do this, follow the steps below:\n\n1. Access the Admin.\n2. In the Marketplace module, click Marketplace and Integrations.\n4. Search for Facebook in the search bar.\n5. Click `Edit`\n6. Choose the `Category Mapping` option.\n6. Click on `Choose a File`.\n7. Select the completed mapping spreadsheet.\n8. Click on `Upload File`.\n\nOnce 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.  \n\n## Using custom labels\n\nIn 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.\n\nCustom labels are useful for:  \n\n- Grouping products by specific campaigns (like Black Friday, Free shipping, etc.)  \n- Creating reports based on product groups that have similar behavior.  \n\n### Setup\n\nYou need to create custom labels on Facebook Business Manager. After creating them, follow the [Adding product specifications or fields](/en/docs/tutorials/adding-specifications-or-product-fields) tutorial to link them to a specific offer using **product specifications**.\n\nAdd the following value when creating the new product specification field:\n\n| **Field** | **Value** |\n|:---: | :---: |\n| __Specification field name__ | `facebook-labels`|\n|Field type | Radio |\n\nAfter creating the specification, you need to link it to your offers by following the instructions below:  \n\n1. 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.  \n2. In the product row, click the vertical ellipsis icon and then `Edit product`.  \n3. Go to the **Product** tab.  \n4. Complete the `facebook-labels` field with the desired values separated by semicolons `;`.  \n5. Click `Save`.  \n\n> ⚠️ An offer can have a maximum of five linked labels."}