This attribute specifies the full title of the promotion. Titles must provide a complete, accurate description of the promotion that is easy to understand and doesn't mislead customers.
On this page
When to use
Required for all promotions.
Format
Follow these formatting guidelines to make sure that Google understands the data that you submit.
| Type | Unicode characters (Recommended: ASCII only) |
| Limits | 1–60 characters |
| Repeated field | No |
| File format | Example entry |
|---|---|
| Text feeds | Free mug with purchase |
| XML feeds | <g:long_title>Free mug with purchase</g:long_title> |
To format your data for Content API, see the Content API for Shopping resource.
Minimum requirements
These are the requirements that you must meet to show your product in Merchant Center. If you don't follow these requirements, your product will be disapproved and you'll receive a notification in your Merchant Center account.
- Promotion titles must match the language of the target country. Your promotion will be disapproved if the promotion title doesn't comply with this requirement.
- Values in titles must reflect the specific promotion that is applied at checkout.
- Monetary discount must be reflected in the specified area's currency symbol or code. For example: 5,300 INR, 15 AUD.
- Free delivery and discounted delivery promotions should include a redemption code in the promotions feed, not in the title.
- Titles must have specific promotion value and discount. You cannot use generic promotional text. For example, 'Spring shoe sale'.
- Free items must be described in the title and include a monetary value when possible:
- No: Free item with purchase
- Yes: Free memory card with purchase
- No: Gift card/voucher with purchase
- Yes: Free £25 GBP gift card/voucher with purchase
- If a promotion is for new customers, this must be stated in the title. For example: Sign up and get 10% off or 10% off for new customers.
- If a promotion requires a minimum purchase, this must be stated in the title. For example, '£5 GBP off purchases over £20 GBP'.
- Promotion titles must not include any of the following specific redemption details:
- Codes: Redemption codes should only be entered in the fields designed specifically for them in the promotions feed, not in the title.
- Redemption dates: Include dates in any of these formats: 'M/D/YYYY', 'Ends in YYYY', 'MM/DD', 'D January YYYY', etc.
- If a promotion applies to a certain type of product, ensure that you include the name or type of that product in your title.
- Yes: '20% off on baby trainers only'. This title details the specific category that is eligible for coupons or discounts.
- No: '20% off on selected products'. This title makes it difficult for customers to identify if the type of products that they are interested in are included in your promotion.
- If a promotion is good for certain products or types of products, don't create a misleading title that implies otherwise.
- Titles should be consistent with the applicability set in your promotion attribute. For example, if the title says '£15 off all products' or '£15 off all orders', then the products eligible for promotion
[product_applicability]attribute should be set toall_products. - If the promotion is applicable for specific products, for example: '20% off baby trainers only', the products eligible for promotion
[product_applicability]attribute should be set tospecific_products. - If a promotion includes tiered discounts, promotions should show a range of discounts, not just the highest possible value.
- No: Up to £20 off
- Yes: £10 – £20 off or £10+ off
- Yes: £10+ off
- Tiered promotions can be submitted as one promotion or multiple. If you submit a tiered promotion as a single promotion, the title must be within the 60-character limit and state the 'floor' promotion.
- The currency value listed in your title must match the country for where the promotion is targeted.
Best practices
These best practices can help you to go beyond the basic requirements to optimise your product data for performance.
- Ensure that your titles are specific, accurate and easy to understand. Your promotions will be displayed under the 'Coupons from shop' section, so the more specific your promotion titles are, the easier it will be for your customers to find them.
- Be concise. Don't use repetitive words or phrases, or unnecessary or irrelevant text.
- Use correct spelling, grammar and capitalisation. Write in either sentence case or title case – avoid all caps.
- Use appropriate punctuation and symbols. Don't use gimmicky exclamation marks, asterisks or similar.