Loyalty points [loyalty_points]

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

The loyalty points [loyalty_points] attribute is no longer in use. Use the new attribute loyalty programme [loyalty_program] to set up loyalty points and special delivery rates in your Merchant Center account.

Use the loyalty points [loyalty_points] attribute to specify how many and what type of loyalty points a customer receives when buying your product.

In this article

When to use

Optional Optional for products targeting Japan

If you're targeting Japan and you offer loyalty points for purchasing your product, submit information about these points using the loyalty points [loyalty_points] attribute.

This attribute uses three sub-attributes:

  • Loyalty points programme name [name] (optional)
    The name of the loyalty points programme (up to 12 full-width characters or 24 roman characters, e.g. Programme A).
  • Loyalty points value [points_value] (required)
    The number of loyalty points that a customer receives when purchasing your product (e.g. 100).
  • Loyalty points ratio [ratio] (optional)
    The ratio of a point when converted to currency (e.g. 0.5). If you don't include a value, the default is 1.0.


Follow these formatting guidelines to make sure that Google understands the data that you're submitting.

Learn when and how to submit your product data in English

Type Unicode characters (recommended: ASCII only)
Repeated field No
File format Example entry
Text feeds

Format the value by submitting the name, points_value and ratio sub-attribute values, each separated with a colon (:). Don't use quotation marks. All colons, even for blank values, are required. If the value is blank, two colons are required. You should include attributes in order of priority.

For example, for Programme A with 100 points equal to 0.5 currency units, submit:

Programme A:100:0.5

To default to '1.0 currency unit', include the colon but leave the value blank:

Programme A:100:

To submit only '100 points', include the colons and leave the other two values blank:

XML feeds


<g:name>Programme A</g:name>




To format your data for Content API, go to the Content API for Shopping resource.

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 in your Merchant Center account.

  • Provide a date of up to one year in the future.

Best practices

These best practices can help you to go beyond the basic requirements to optimise your product data for performance.

  • Submit loyalty points that have a specific monetary value. Loyalty points are supported only if they have a monetary value. For example, mileage and loyalty points that are only exchangeable with goods aren't supported.
  • Submit points that are issued by you. You can also submit cross-industry points if you issue the points yourself. For example, points associated with credit cards and electronic money aren't supported.


Text feed

Format the value by separating each sub-attribute (name, points_value and ratio) with a colon (:).

For example, for 'Google loyalty programme' with '100 points' where 1 point equals '0.5 currency units', submit:

Google loyalty programme:100:0.5

To default to 1 point equals '1.0 currency unit', include the colon but leave the value blank:

Google loyalty programme:100:

To submit only '100 points', include the colons and leave the other two values blank:


Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue

Clear search
Close search
Google apps
Main menu
Search Help Centre