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 Google understands the data you submit.
| Type | Unicode characters (Recommended: ASCII only) |
| Limits | 1-60 characters |
| Repeated field | No |
| File format | Example entry |
|---|---|
| Text data source | Free mug with purchase |
| XML data source | <g:long_title>Free mug with purchase</g:long_title> |
To format your data for Content API, check 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 is disapproved and you get a notification in your Merchant Center account.
- Promotion titles must match with 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 shipping and discounted shipping promotions should include a redemption code in the promotions source, 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 dollar value when possible:
- No: Free item with purchase
- Yes: Free memory card with purchase
- No: Gift card/voucher with purchase
- Yes: Free $25 USD gift card/voucher with purchase
- If a promotion is for new customers, it 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, it must be stated in the title. For example: $5 USD off purchases over $20 USD.
- 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 source, not in the title.
- Redemption dates: Include dates in any of these formats: "M/D/YYYY," "Ends in YYYY," "MM/DD," "January D, YYYY," etc.
- If a promotion applies to a certain type of product, ensure you include the name or type of that product in your title.
- Yes: "20% off on baby sneakers only". This title details the specific category that is eligible for coupons or discounts.
- No: "20% off on select products". This title makes it difficult for customers to identify if the type of products 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 on baby sneakers 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 go beyond the basic requirements to optimize your product data for performance.
- Ensure your titles are specific, accurate, and easy to understand. Your promotions will be displayed under the “Coupons from store'' section, so the more specific your promotion titles are, the easier it will be for your customers to find.
- Be concise. Don’t use repetitive words or phrases, or unnecessary or irrelevant text.
- Use correct spelling, grammar, and capitalization. Write in either sentence case or title case, avoid all-caps.
- Use appropriate punctuation and symbols. Don’t use gimmicky exclamation marks, asterisks, or the like.