Use the price [price]
attribute to tell users how much you’re charging for your product. This information is shown to users.
When to use
Required for each product
[unit_pricing_measure]
and unit pricing base measure [unit_pricing_base_measure]
attributes.
Format
Follow these formatting guidelines to make sure Google understands the data you submit.
Learn when and how to submit your product data in English.
Type | Number plus currency (use ISO 4217) |
---|---|
Repeated field | No |
Schema.org property (What's this?) |
Learn more about Merchant listing (pricing) structured data on Google Search Central. |
File format | Example entry |
---|---|
Text feeds | 15.00 USD |
XML feeds | <g:price>15.00 USD</g:price> |
To format your data for Content API, go to the Content API for Shopping resource
Minimum requirements
These are the requirements you need to meet to show your product. If you don't follow these requirements, we disapprove your product and let you know in your Merchant Center account.
- Make sure that the price in your product data meets both the landing page and checkout requirements. Learn more About landing page requirements.
- Submit an amount and currency that match the price on your landing page and the checkout pages. Learn more currency requirements for your target country.
- Show the price in the currency of your target country prominently on your landing page and checkout pages.
- Don’t change the price of your product on your landing page based on a user’s location.
- If the price of your product changes based on the user's location you need to join and use the regional pricing program where available.
- Make sure that any user in the target country can buy the product for the submitted price. You may require a user to sign-up for an account.
- If account creation through signup is necessary, it must be free and straightforward, and can be completed on the landing page or during checkout.
- As part of signup, you may verify the new account information through an activation code sent by email or by SMS.
- If account sign-up changes the price that the user pays for the purchase, then you must use the loyalty program
[loyalty_program]
attribute to submit a member price.
- Discount or coupon prices are allowed in the price
[price]
attributes if the following conditions are met:- The discount or coupon prices are available to every user.
- The price after applying the discount or coupon is displayed clearly on the landing page.
- For more advanced promotional pricing, you can use the Promotions feature.
- Don’t submit a member price in the price [price] or sale price
[sale_price]
attributes. You can only submit member prices for both paid and free programs using the loyalty program[loyalty_program]
attribute, where available. Learn more about loyalty programs. - Display variants and their prices in a straightforward way on your landing page.
- Don’t submit products with a price that constantly changes, such as auctions and prices based on a live currency exchange.
- Keep your prices up to date. If the price changes, make sure to provide the latest price value.
- Submit all additional charges at the checkout that you charge as a merchant, and that are not included in the price on your landing page with the shipping cost in the shipping
[shipping]
attribute, or using the Merchant Center shipping settings. For example, service, processing, activation, and handling fees that you charge and that are not government-imposed. - Don’t include shipping costs in your price. Instead, use Merchant Center shipping settings or the shipping
[shipping]
attribute in the feed. - Include any minimum order value in your shipping settings.
- Don’t include any import- or export-related costs in your price. Instead, clearly indicate relevant charges on your website.
- Don't provide more than 2 digits after the decimal point. If you include more than 2 digits after the decimal point, they are automatically rounded to the nearest acceptable value. For example, 1.0234 will be rounded to 1.02 and 29.8999 will be rounded to 29.90.
- Don’t include activation fees for wireless plans in the price that you submit for mobile devices and tablets sold in the US. Wireless subscription plans aren't supported for Shopping ads and free listings in the US.
- Comply with local laws when submitting price information.
Best practices
These best practices can help you go beyond the basic requirements to optimize your product data for performance.
- Submit a price that can be represented in the currency of your target country according to ISO 4217. For example, instead of 1.0012 USD, submit 1.01 USD. If your price can’t be represented in the currency of your target country, then we round it to a value that can.
- Enable automatic item updates for price. Automatic item updates use the Schema.org microdata on your landing page to help keep your data fresh. Keep in mind that these updates only happen when Google crawls your landing page, and you still need to resubmit your product data regularly.
- Highlight sales that promote your products. Use the sale price
[sale_price]
attribute to tell users how much you’re charging for your product during a sale. During the period that you specify, your sale price will show as the current price for your product. If your original and sale prices meet certain requirements, your original price may show along with the sale price, allowing people to see the difference between the two prices. - Feature member prices to promote your loyalty programs. Add member prices using the loyalty program
[loyalty_program]
attribute for both free and paid loyalty programs. You can set up your loyalty program to show your member price alongside the regular price[price]
. Learn more about the Loyalty program[loyalty_program]
attribute. - Use currency conversion as an easy way to target a country that uses a different currency than the one on your website and in your product data. If you use currency conversion, the prices on your landing page, checkout pages, and in your product data must still match. We display the converted price in your ad or free listing, but the converted price doesn't need to appear on your landing page or at checkout. Learn more About currency conversion.
Additional guidelines
Review each section closely to determine if the requirements apply to your country or product. If you don't follow requirements that apply to you, we disapprove your product and let you know in your Merchant Center account.
Vehicle ads
- United States: Price should be the actual price for which any consumer can purchase the advertised vehicle, excluding only required government charges and fees.
Business-to-business (B2B) focused retailers
- Submit a price that includes value-added tax (VAT) if necessary for your target country. If you’re required to submit VAT in the price, then make sure that the same price including VAT is visible on your landing page and at checkout. Learn more about B2B advertising
Minimum order value
- Specify any minimum order value that you require in your shipping settings. For example, if your product costs 10 USD, and you require that users spend at least 50 USD to place an order, then that would be a minimum order value. Specify a minimum order value of 50 USD for the affected shipping service. This feature is only available in the classic Merchant Center experience.
Merchant-defined bundles and multipacks
- Submit the total price for your entire bundle or multipack. Learn more about the bundle
[is_bundle]
and multipack[multipack]
attributes.
Products sold in bulk or minimum order quantity
- Submit the price for the minimum number of products that you require a user to purchase. Don't submit the price for only one product if a user can't purchase only one product. For example, if you sell ballpoint pens, and users must purchase at least 50 ballpoint pens to place an order, then submit the price for 50 ballpoint pens.
- The landing page of the product can also list the minimum quantity and price per unit instead of the total price for the minimum number of items sold. This information should not be confusing or misleading the shoppers.
Note: If you require a minimum total number of products (either multiples of the same product or a combination of different products) in order for a customer to complete a purchase of those products, declare the cost of the total minimum number of products as the minimum order value in your shipping settings.
Products with minimum advertised pricing agreements
- Submit the minimum advertised pricing (MAP) value as the "price" in your product data if you sell the product for less than the price allowed by third-party agreements.
- Show the MAP price on your product landing page. You can show that you charge a lower price at checkout by adding clarifying text to your product pages. For example, you could display a note such as “Add to cart for final price” and show the MAP value crossed out or dimmed. The MAP price in your product data must show on the landing page. Learn more About requirements for landing pages
- If you use microdata annotations on your website, include the MAP as the price there also.
Mobile phone or tablet sold with installment payments
- Submit the price as the total payment, including activation fees, if paid in-full up-front (as an alternative to paying in installments). This guideline only applies if installment payments are allowed in the target country. Learn more about requirements for advertising wireless products and services.
Mobile phone or tablet prepaid up-front or sold with installment payments and/or a subscription plan: Australia
- Submit the price as the total cost of the device and/or installment and/or wireless service payments, including activation fees. The price must be the total minimum cost that the customer must pay for the duration of the contract for the device plus installment and wireless service plan payments, if applicable. Learn more about requirements for advertising wireless products and services.
Mobile phone or tablet prepaid up-front or sold with installment payments: United States
- Submit the price as the total payment, if paid in-full up-front (as an alternative to paying in installments). Don’t include activation fees for wireless plans. Learn more about requirements for advertising wireless products and services.
Tax: Canada and the United States
- Don't include any taxes, such as a Goods and Services Tax (GST), value-added tax (VAT), sales tax, or import tax, in the price
[price]
attribute.
[shipping]
, price [price]
, tax [tax]
, or any other attribute. Learn more about Colorado retail delivery fee.- Provide the product price, including any value-added tax (VAT) or Goods and Services Tax (GST), in the price
[price]
attribute, and ensure that the landing page price matches the price in your product data. Don’t use the tax[tax]
attribute.
Software subscriptions
- Submit the price for the full length of the software subscription, with a minimum of 1 year (12 months). If the prepaid subscription comes with any subsidized or free periods, then include those periods in the total price. If your subscription costs more (or less) for the first year than for the following years, submit the prepaid price for the first year. If you like, you can instead submit the prepaid price for multiple years. Learn more about submitting software subscriptions
Magazine and newspaper subscriptions
- Submit the price for the full length of the magazine or newspaper subscription, with a minimum of 1 year (12 months). If the prepaid subscription comes with any subsidized or free periods, then include those in the total price. If your subscription costs more (or less) for the first year than for the following years, submit the prepaid price for the first year. You can submit the prepaid price for multiple years.
- Clearly state in your renewal and cancellation terms whether the subscription is for a fixed term or is automatically renewed. Also explain the cancellation options and under which conditions the auto-renewal occurs after the prepaid duration has ended.
- Submit shipping cost as 0 (if shipping cost is required for your target country). For example, 0.00 USD, 0.00 EUR, 0.00 GBP. You can submit shipping costs through the shipping
[shipping]
attribute or through your account shipping settings.
Export and cross-border trade
- Prominently state on your website if import-related charges apply. For example, add information on your landing page or during checkout so users are aware of these costs before they place the order. Don’t submit import- or export-related costs as part of the tax
[tax]
or price[price]
attributes. - Understand for which country or region you must meet price and tax requirements. If you choose to show a currency that isn't the currency of the target country or region, you must follow the price and tax requirements for the country or region that your currency is local to.
Examples
VariantsProduct data for a small Google t-shirt priced at 10.99 USD | |
Attribute | Value |
Title [title] |
Google T-Shirt - Green - Small |
Price [price] |
10.99 USD |
Color [color] |
Green |
Size [size] |
S |
ID [id] |
9876-S-GRN |
Item group ID [item_group_id] |
9876 |
Product data for a small blue Google t-shirt priced at 8.99 USD | |
Attribute | Value |
Title [title] |
Google T-Shirt - Blue - Small |
Price [price] |
8.99 USD |
Color [color] |
Blue |
Size [size] |
S |
ID [id] |
9876-S-BLU |
Item group ID [item_group_id] |
9876 |
Product data for a small yellow Google t-shirt priced at 10.50 USD | |
Attribute | Value |
Title [title] |
Google T-Shirt - Yellow - Small |
Price [price] |
10.50 USD |
Color [color] |
Yellow |
Size [size] |
S |
ID [id] |
9876-S-YELLOW |
Item group ID [item_group_id] |
9876 |
Product data for a new, Very Silver, 32 GB Google Pixel 5 priced at a 700 USD full payment at checkout or an alternative installment payment option of 12 monthly payments of 60 USD with no down payment | |
Attribute | Value |
Title [title] |
Google Pixel 5 32 GB Very Silver (with 12 monthly payments) |
Price [price] |
700.00 USD |
Installment [installment] |
12:60.00 USD: 0.00 USD |
Google product category [google_product_category] |
Electronics > Communications > Telephony > Mobile Phones |
For more examples, go to best practices for advertising wireless products and services.
Phone or tablet with installment payments (Australia)
The installment plan includes the product cost for 12 months plus the cost of the subscription for 12 months.
Product data for a midnight blue Google Pixel XL phone priced at 1,250.00 USD | |
Attribute | Value |
Title [title] |
Google Pixel XL - 32 GB - Midnight Blue (with 12 month contract and 12 installment payments) |
Price [price] |
1250 AUD |
Google product category [google_product_category] |
Electronics > Communications > Telephony > Mobile Phones |
For more examples, go to best practices for advertising wireless products and services.
Merchant-defined multipacks and bundles
Product data for 3 green Google t-shirts in a multipack priced at 41.50 USD | |
Attribute | Value |
Title [title] |
Google T-Shirt - 3-Pack - Green - Small |
Price [price] |
41.50 USD |
Brand [brand] |
|
GTIN [gtin] |
121314151617 |
Multipack [multipack] |
3 |
Product data for a 25.3 MP Google digital SLR camera, with 35mm lens for 432.50 USD, includes a blue camera bag priced at 10.99 USD | |
Attribute | Value |
Title [title] |
Google 25.3 MP Digital SLR Camera Body + 35mm Lens + blue camera bag |
Price [price] |
432.50 USD |
Brand [brand] |
|
GTIN [gtin] |
123456789011 |
Bundle [is_bundle] |
yes |
Products with a minimum order value requirement
Products sold in bulk or minimum order quantity
Product data for a package of 1,000 flat head sheet metal screws priced at 7.50 USD | |
Attribute | Value |
Title [title] |
Flat Head Sheet Metal Screws (Pkg. 1000) |
Price [price] |
7.50 USD |
Product data for customized ballpoint pens that cost .20 USD with a minimum order quantity of 50 pens | |
Attribute | Value |
Title |
Ballpoint pens (50) |
Price [price] |
10 USD |
Some sites may require a customer to meet a minimum order quantity of products, rather than a minimum order value, to complete a purchase. For example, if you sell sleeves of coffee capsules, you might require a user to purchase a minimum of 5 sleeves. However, if the sleeves vary in price depending on the type of coffee, you may not be able to provide a price for this minimum order quantity. In this case, you’ll need to use a minimum order value (MOV). Note that the MOV is calculated in Merchant Center using price rather than quantity, so you need to submit the highest possible price for 5 sleeves as the MOV.
Here’s how to submit your product data:
Product data for one sleeve of coffee capsules, priced at 20 EUR per sleeve with a minimum order requirement of 5 sleeves, which can be a mix of any coffee capsules | |
Attribute | Value |
Title [title] |
Coffee Capsules (one sleeve of 10 capsules) |
Price [price] |
20.00 EUR (1 sleeve) |
Unit pricing measure [unit_pricing_measure] |
10 ct (Optional) |
Unit pricing base measure [unit_pricing_base_measure] |
1 ct (Optional) |
Shipping settings | Minimum order value: 100.00 EUR |
Unit pricing
Product data for a 30 ml Eau de Parfum priced at 43.95 EUR | |
Attribute | Value |
Title [title] |
Eau de Parfum - 30 ml |
Price [price] |
43.95 USD |
Unit pricing measure [unit_pricing_measure] |
30 ml |
Unit pricing base measure [unit_pricing_base_measure] |
100 ml |
Software subscription
Product data for a 1-year subscription to a Google Security Software Basic Edition priced at 29.90 USD | |
Attribute | Value |
Title [title] |
Google Security Software Basic Edition (1-year subscription) |
Price [price] |
29.90 USD |
Google product category [google_product_category] |
Software > Computer Software > Antivirus & Security Software |
Brand [brand] |
|
MPN [mpn] |
123GOOGLE432 |
GTIN [gtin] |
1234567890123 |
Shipping [shipping] |
0.00 USD |
Image link [image_link] |
https://example.com/image1.jpg |