Notification

In this Help Centre, you can find content for both Merchant Center Next and the classic Merchant Center experience. Look for the logo at the top of each article to make sure that you're using the article for the Merchant Center version that applies to you. 

Promotion title [long_title]

A custom icon for Merchant Center Classic and Merchant Center Next.

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 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 is disapproved and you receive a notification in your Merchant Center account.

  • 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', 'January D, 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 applies to 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 to all_products.
  • If the promotion is applicable to specific products, for example: '20% off on baby trainers only', the products eligible for promotion [product_applicability] attribute should be set to specific_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.

Was this helpful?

How can we improve it?
true
Search
Clear search
Close search
Main menu
11163897715377639920
true
Search Help Centre
true
true
true
true
true
71525
false
false