Use the sale price [sale_price] attribute to tell customers how much you're charging for your product during a sale. During a sale, your sale price will be shown as the current price. If your original price and sale price meet certain requirements, your original price may be shown along with the sale price, allowing people to see the difference between the two.
When to use
Optional for each product
If your product is on sale, submit the new price using the sale price [sale_price] attribute. To submit the dates of your sale, use the sale price effective date [sale_price_effective_date] attribute.
Format
Follow these formatting guidelines to make sure that Google understands the data that you're submitting.
| Type | Number plus currency (use ISO 4217) |
|---|---|
| Repeated field | No |
| File format | Example entry |
|---|---|
| Text feeds |
|
| XML feeds | <g:sale_price>15.00 GBP</g:sale_price> |
To format your data for Content API, have a look at the Content API for Shopping.
Guidelines
Follow these guidelines to make sure that you submit high quality data for your products.
Minimum requirements
These are the requirements that you'll need to meet to show your product. If you don't follow these requirements, we'll disapprove your product and let you know on the Diagnostics page of your Merchant Center account.
- Meet the same requirements as those for showing price via the price attribute with some exceptions.
- The sale price does not have to be the most prominent price on the landing page. For example, if you display price and sale price, the original price can still be in a larger font.
- Clearly display both non-sale and sale prices on your landing pages, and only the sale price at checkout. If you advertise a coupon code, you will need to ensure that it's accessible to all users and it clearly displays both the non-sale price and the sale price after applying the coupon code. You will also need to ensure that the sale price remains consistent throughout checkout.
- Submit a value that matches the sale price you display on your landing page and at checkout.
- Submit the full price of your product (the cost when it's not on sale) by also submitting the price
[price]attribute when you submit the sale price[sale_price]attribute. If your product is on sale and you don't submit the sale price attribute, you should submit the sale price as the value for the price attribute. - The sale price should be less than the price for any given product, and this should be reflected in your product data.
- Don't provide more than two digits after a decimal. If you include more than two digits after the decimal, they'll automatically be 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.
Best practices
These best practices can help you go beyond the basic requirements to optimise your product data for performance.
- Submit a value that can be represented in the currency of your country of sale (according to ISO 4217). For example, instead of 1.0012 GBP, submit 1.01 GBP. If your price can't be represented in the currency of your country of sale, we'll round it to a value that can.
- Submit the date range for which the sale price applies. Submit the sale price effective date
[sale_price_effective_date]attribute to indicate when the sale price is relevant; otherwise the sale price will be used for your product right away. - Submit correct base prices to enable sale price annotations. If you want to lower the price of a product for a sale, submit the sale price with the sale price
[sale_price]attribute. Keep submitting the original base price that you charged previously with the price[price]attribute. Learn more about requirements to show sale price annotations for your products
Examples
If you sell a product that comes in multiple colours and sizes, you might choose to put some of the colours on sale.
|
Product data for a small green Google logo T-shirt, priced at 10.99 USD, on sale for 9.99 USD |
|
|
Attribute |
Value |
|
Title Price |
Google T-shirt – Green – Small 10.99 USD |
|
Sale price |
9.99 USD |
|
Colour |
Green |
|
Size |
S |
|
Product data for a small blue Google logo T-shirt, priced at 8.99 USD, on sale for 5.99 USD |
|
|
Attribute |
Value |
|
Title |
Google T-shirt – Blue – Small |
|
Price |
8.99 USD |
|
Sale price |
5.99 USD |
|
Colour |
Blue |
|
Size ID Item group ID |
S 9876-S-BLU 9876 |
|
Product data for a small yellow Google logo T-shirt, priced at 10.50 USD, on sale for 8.99 USD |
|
|
Attribute |
Value |
|
Title |
Google T-shirt – Yellow – Small |
|
Price |
10.50 USD |
|
Sale price |
8.99 USD |
|
Colour |
Yellow |
|
Size |
S |
|
ID Item group ID |
9876-S-YELLOW 9876 |
You can submit a price as low as 0 for mobile phones or tablets that come with a contract. Learn more about the requirements.
|
||||||||||||||||||||||