Stable offer identifier used to distinguish one product from another.
Microsoft Shopping field guide
Microsoft Shopping product data field guide
A practical field-by-field guide for reviewing Microsoft Shopping product feeds, including important attributes, field purpose, and Microsoft Merchant Center references.
Guide sections
Required product data
These fields are the first priority because missing or invalid values can prevent products from being accepted or shown correctly.
ID
id
Required
Title
title
Required
The customer-facing product name shown in Microsoft Shopping experiences.
Description
description
Required
Product description text that explains what the product is and what it offers.
Link
link
Required
Landing page URL for the product.
Condition
condition
High
Product condition such as new, refurbished, or used.
Product identifiers
Identifiers help Microsoft Merchant Center match products and understand manufacturer data.
Brand
brand
Very high
Brand or manufacturer name.
GTIN
gtin
Very high
Global trade item number, such as EAN, UPC, ISBN, or JAN.
MPN
mpn
High
Manufacturer part number, often used when a GTIN is not available.
Identifier exists
identifier_exists
High
Indicates whether a product has manufacturer identifiers.
Category and classification
Category fields help classify products and improve campaign structure.
Microsoft product category
google_product_category
High
Google-style product taxonomy ID or path used by Microsoft Shopping.
Product type
product_type
High
Merchant-defined product category path.
Price and availability
These fields describe what the customer can buy, for what price, and under which availability status.
Price
price
Required
Product price with currency.
Availability
availability
Required
Stock status such as in stock, out of stock, or preorder.
Sale price
sale_price
Optional
Temporary discounted product price.
Images
Image fields affect product presentation and should point to crawlable product images.
Image link
image_link
Required
Main product image URL.
Additional image link
additional_image_link
Optional
Extra product image URLs for additional views.
Variants and details
Variant fields help separate products that differ by size, color, material, or audience.
Shipping and campaign controls
These fields support delivery details, campaign labels, and optional feed controls.
Shipping
shipping
Optional or market-dependent
Feed-level shipping details such as country and price.
Custom labels
custom_label_0
Optional
Campaign segmentation labels such as season, margin, or promotion group.
Related fields: custom_label_1 custom_label_2 custom_label_3 custom_label_4