Add structured data attributes
This article lists all of the structured data attributes that you can provide in your Promotions feed.
Optional structured data fields are attributes that provide additional information about your promotion type (e.g. 10% off and buy one, get one free). Structured data allows Google to display more detailed information about your Shopping ad promotions to shoppers on mobile devices.
Note: All structured data attributes that you submit must match information in your promotion's
long_title [long_title]. During the review process, Google validates your data. If information does not match the
long_title [long_title], Google will edit the structured fields to match the information in the
long_title [long_title]. If you don't submit the structured data for your promotion, Google attempts to structure your promotion based on the
Promotion benefit types and attributes
The promotion benefit type determines the specific kind of offering that your promotion will provide and the corresponding structured data attribute that you include in your feed.
|Promotion benefit type||Attribute|
|Percent off (e.g. 10% off)||percent_off [percent_off]|
Money off (e.g. £200 off)
Buy M get money off (e.g. £60 off
purchase of 5+ summer tops)
Buy M get percent off (e.g. buy 2
beauty items, save 15%)
Buy M get B money off (e.g. buy 4
shirts, get 5th shirt £10 off)
Buy M get N percent off (e.g. buy one, get one
free; or buy 2 books, get 3rd 20% off)
|Free standard, overnight or 2-day shipping||free_shipping [free_delivery]|
Free gift (e.g. free beach tote bag and blanket
Provide one of the following, depending
on the details of your free gift promotion:
The percent discounted for percentage-based promotions (e.g.10 % off).
Important: Do not include the percent symbol.
The monetary value discounted for fixed discount promotions (e.g. £200 off)
Important: Do not include the currency.
The minimum purchase quantity required to redeem promotions offering 'Buy M, get N'. This field represents the 'M' value for the offer.
- Example promotion: Buy two, get one free
- Example promotion: Buy 4, get £100 off
The quantity discounted once the minimum quantity required to purchase has been met in 'Buy M, get N discounted' promotions. This field represents the 'N' value of the offer.
- Example promotion: Buy two, get third one £5 off
For promotions offering free delivery, this attribute indicates the type of free delivery offered.
- Valid values
The monetary value of any free gift offered in the promotion.
- Example (US): 50 USD
- Example (IN): 600 INR
- Example (AU): 20 AUD
- Example (FR/DE): 10 EUR
- Example (GB): 25 GBP
Important: include currency in this attribute. The
price attribute must be formatted correctly. Learn more about price attribute requirements.
The description of any free gift offered in the promotion.
Important: the description cannot contain more than 100 characters.
item id [item id] of any free gift offered in the promotion.
item id [item id] will match to the
targeting_channel [targeting_channel] specified. The
id [id] attribute must be formatted correctly. Learn more about price attribute requirements.