Paddy Remaps

Only Christmas 🎅 special offer till end Dec 2021

Christmas Eve Special Offer All Customers 10% off also Free Diagnostic Before Remap

eld Description
id
A unique content ID for the item. Use the item's SKU if possible. Each content ID must only appear once in your catalogue. Character limit: 100.

Note: To use this item in dynamic ads, this ID must exactly match the content ID for the same item in your Facebook pixel code. This tells us that it's the same item in your catalogue and on your website.

Example: 12345

title
A specific, relevant title for the item. See product title specifications. Character limit: 150.

Example: Blue cotton T-shirt

description
A short, relevant description of the item. Include specific and unique product features such as material or colour. Use plain text (not HTML) and don't enter text in all capital letters or include any links. See product description specifications. Character limit: 5,000.

Example: Royal blue women's T-shirt in organic cotton. Relaxed fit.

availability
The current availability of the item. Supported values: in stock, available for order, out of stock. Note that if an item is out of stock, it appears as out of stock in sales channels and doesn't appear at all in ads.

Example: in stock

condition
The condition of the item. Supported values: new, refurbished, used.

Example: new

price
The price of the item. Format the price as a number, followed by a space and then the 3-letter ISO 4217 currency code. Always use a period (".") as the decimal point, not a comma (","). Don't include currency symbols such as "$".

Examples: 9.99 USD or 7.99 EUR

link
The URL of the specific website page where people can learn more about or buy the item. Links must be valid and begin with http:// or https://.

Example: http://www.jaspersmarket.com/products/shirt

image_link
The URL for the main image of your item. Images must be in JPEG or PNG format, at least 500 x 500 pixels and up to 8 MB. See product image specifications.

Example: http://www.jaspersmarket.com/products/shirt.jpg

Note: If you change the image later, the new image must use a different URL or the change won't be recognised.

brand
The brand name, unique manufacturer part number (MPN) or Global Trade Item Number (GTIN) of the item. You only need to enter one of these, not all of them. For GTIN, enter the item's UPC, EAN, JAN or ISBN. Character limit: 100.

Example: Jasper's Market

Sellers in the US can also use Checkout on Facebook and Instagram, which allows customers to complete purchases directly on our platforms. To sell with checkout, you must also include the following fields:

Field Description
quantity_to_sell_on_facebook
Only include this field if you sell with checkout. This field was previously called inventory. We recommend that you use the new name.

The quantity of this item that you have available to sell on Facebook and Instagram. Enter a whole number. We automatically reduce an item's quantity each time a purchase order is confirmed through checkout.

Note: To display as in stock for checkout, an item's quantity_to_sell_on_facebook must be 1 or higher and its availability field must also be set to in stock.

Example: 150

fb_product_category
Required if you sell with checkout, but recommended for all shops. Use this field or google_product_category, or both.

The Facebook product category for the item. See the Facebook product categories list (US English) or find other languages. Use either the category's taxonomy path or its ID number. This field is not case sensitive.

Examples: Clothing & Accessories > Clothing > Women's Clothing > Tops & T-Shirts or 430

After you've provided a category, we recommend that you include optional fields specific to that category.

google_product_
category
Required if you sell with checkout, but recommended for all shops. Use this field or fb_product_category, or both.

The Google product category for the item. See Google product categories (US English) or learn more about categories. Use either the category's taxonomy path or its ID number. This field is not case sensitive.

Examples: Apparel & Accessories > Clothing > Shirts & Tops or 212

After you've provided a category, we recommend that you include optional fields specific to that category.

Optional fields for products
You can also include many optional fields for products to enhance the quality of your catalogue and control how items are displayed. Here are some useful optional fields:

Field Description
sale_price
The discounted price of the item, if it's on sale. Use the same formatting instructions as the price field.

Example: 5.99 USD

sale_price_
effective_date
The date, time and time zone when your sale starts and ends. If you don't add this field, any items with a sale_price remain on sale until you remove their sale price. Use this format:

YYYY-MM-DDT23:59+00:00/YYYY-MM-DDT23:59+00:00

Enter the sale start date as YYYY-MM-DD, followed by a "T".
Enter the start time in 24-hour format (00:00 to 23:59) followed by the UTC time zone (-12:00 to +14:00).
Enter a "/". Then, repeat the same format for the date and time when your sale ends.
Example: 2020-04-30T09:30-08:00/2020-05-30T23:59-08:00
Note: This example uses PST time zone (-08:00).

item_group_id
Allows you to set up variants of the same product, such as different sizes, colours or patterns. Enter the same group ID in this field for all variants of the same product to indicate that they're part of a group. Learn more about variants.

Example: Cotton_Shirt_1

status
This field was previously called visibility. We recommend that you use the new name.

Controls whether the item is active or archived in your catalog. Only active items can be seen by people. Supported values: active, archived. Items are active by default. Learn more about archiving items.

Note: Some partner platforms may sync items to your catalog with a status called "staging", which behaves the same as "archived".

Example: active

additional_
image_link
The URLs for up to 20 additional images of your item, separated by a comma. Follow the same image specifications as the main image_link field.

Example: http://www.jaspersmarket.com/products/shirt2.jpg, http://www.jaspersmarket.com/products/shirt3.jpg

color
The main colour of the item. Describe the colour in words, not a hex code. Character limit: 200.

Example: royal blue

gender
The gender your item is targeted towards. Supported values: female, male, unisex.

Example: unisex

size
The size of the item. Enter the size as a word, abbreviation or number, such as small, XL or 12. Character limit: 200.

Example: medium

age_group
The age group that the item is targeted towards. Supported values: adult, all ages, teen, kids, toddler, infant, newborn.

Example: adult

material
The material the item is made from, such as cotton, polyester, denim or leather. Character limit: 200.

Example: organic cotton

pattern
The pattern or graphic print on the item. Character limit: 100.

Example: stripes

shipping
Shipping details for the item formatted as: Country:Region:Service:Price

Enter the country as a 2-letter ISO 3166 country code.
Enter the region, state or province. If shipping information is the same for an entire country, you can leave out the region but keep the :: as shown in the Philippines (PH) example below.
Enter the shipping service, such as ground or air.
Enter the price as a number followed by a space and then the 3-letter ISO 4217 currency code. Note: To use the free shipping overlay for ads, enter the price as 0.0.
If you offer different shipping details by region or country, separate each set of details with a comma (,) as shown below.
Example: US:NY:Ground:9.99 USD, PH::Air:300 PHP

shipping_weight
The shipping weight of the item in lb, oz, g or kg.

Example: 0.3 kg

custom_label_0, custom_label_1, custom_label_2, custom_label_3, custom_label_4
Up to five custom fields for any additional information that you want to filter items by when you create sets. For example, you could use a custom field to indicate all items that are part of a summer sale, and then filter those items into a set.

Example: Summer sale

These are just some of the optional fields available. See the full list of optional fields (Facebook for Developers).

Supported fields for travel, automotive and property
If you're a travel, automotive or property advertiser, check the fields to include in your data feed on the Facebook for Developers website:

Fields for hotel ads
Fields for flight ads
Fields for destination ads
Fields for automotive inventory ads
Fields for property ads
File formats and size limits for data feeds
Supported formats: CSV, TSV or XML (RSS/ATOM). Or, set up your data feed in Google Sheets and we can convert your shareable link to an accepted format automatically.
File size limit: 100 MB for a one-off file upload or 8 GB for a scheduled feed. We also support compressed ZIP and GZIP files up to 30 GB. Files over 4 GB may take several hours to upload, so you may want to split it into multiple feeds and upload them separately.
Item limit: One million items per data feed recommended. If your feed contains more items, split it into multiple feeds and upload them separately.
Line length limit: 5 MB (5,242,880 characters) for each line or row of your data feed.
You can compare file formats and view some example files below:

Format Description Examples
CSV (comma-separated value)
You can create a CSV with most spreadsheet programs, such as Excel or Google Sheets. Enter fields as column names in the top row. In the rows below, enter item information.

Note: If you create your CSV in a text editor or use a custom engineering solution to generate the CSV, you must enclose any fields containing commas or white space in "double quotes" to avoid formatting errors. To use double quotes inside a double quoted field, use consecutive double quotes. For example, "This item, designed in 2020, meets ""XYZ"" standards". If you're using a spreadsheet program such as Excel or Google Sheets, you don't need to do this.

Follow guide to download a CSV template
TSV (tab-separated value)
You can create a TSV with most spreadsheet programs, such as Excel or Google Sheets. Enter fields as column names in the top row. In the rows below, enter item information.

Products, Flights, Hotels, Destinations, Vehicles
XML (RSS/ATOM)
A more technical data feed solution, used with coding programs like ATOM or basic text editors. Typically generated by automated feed provider systems or web servers. Use a series of tags to enclose each item. Your file must begin with a valid

Import a data feed file to Google Sheets

Top quality Mapps Geniune Top quality Tools