Headline_offer_subscription_cost [headline_offer_subscription_cost]

Use the headline_offer_subscription cost [headline_offer_subscription_cost] attribute to include the details of a monthly or annual payment plan that bundles a communications service contract with your wireless product (mobile phone or tablet).

In this article

• When to use
• Format
• Minimum requirements
• Best practices
• Examples

When to use

Optional for each product

This attribute is only available in certain countries:

• Europe: Austria, Belgium, Czechia, Denmark, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Norway, Poland, Portugal, Romania, Slovakia, Spain, Sweden, Switzerland, United Kingdom

This attribute is only supported for mobile products with the following Google product category code (GPC):

• Watches (ID: 201)
• Mobile Phone (ID: 267)
• Tablet Computers. (ID: 4745)
• Mobile Phone Prepaid Cards & SIM Cards (ID: 6030)
• GPS Tracking Devices (ID: 6544)

This attribute uses 3 sub-attributes:

• Period [period] (Required): The duration of a single subscription period, either month [month] or year [year].
• Period length [period_length] (Required): Integer, the number of subscription periods (months or years) that the buyer pays.
• Amount [amount] (Required): ISO 4217, the amount the buyer pays per month. When displaying this amount, the nearest whole unit of local currency may be rounded to save space. The provided value must exactly match the amount as shown on your site.

Format the value by submitting period [period], period length [period_length], and amount [amount] separated with colons (:). Don’t use quotation marks.

Format

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

Learn more about When and how to submit product data in English.

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

Minimum requirements

These are the requirements 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.

• Include the total amount due at checkout in the headline_offer_price [headline_offer_price] attribute.
• When used in combination with the headline_offer_installment [headline_offer_installment] attribute, also include the total amount due at checkout in the downpayment [downpayment] sub-attribute of the headline_offer_installment [headline_offer_installment] attribute.
• Match the communications payment plan that you display on your landing page. You can also display other communication options on your landing page, but the plan that you submit must be straightforward to find on the landing page.
• Don’t require that users have a loyalty card to choose the service plan that you submit.
• Don't use the subscription cost attribute for software subscriptions. Software subscriptions must be prepaid, and submitted using the yearly prepaid cost as the headline_offer_price [headline_offer_price] attribute.
• Use in approved countries only. Use of the subscription cost attribute in unapproved countries will result in disapprovals.
• Use for approved product categories only. Use of the subscription cost attribute for other categories of products will result in disapprovals.

Best practices

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

• Submit exact values for your subscription costs according to ISO 4217.
  • For example, submit 1.01 EUR instead of 1.0012 EUR. Otherwise, the submitted value will be rounded. Use the same currency for headline_offer_subscription_cost [headline_offer_subscription_cost], headline_offer_installment [headline_offer_installment], and headline_offer_price [headline_offer_price].
• If the product is also paid for in monthly installments, use the same number of months for the headline_offer_subscription_cost [headline_offer_subscription_cost] as for the installments.
• If your product has installment payments, submit the same number of months for the headline_offer_subscription cost [headline_offer_subscription_cost] attribute as for the headline_offer_installment [headline_offer_installment] attribute.
  • If the number of months is different and your [headline_offer_installment] and [headline_offer_subscription_cost] need to be combined due to space constraints, the highest of the 2 values will be used.
  • For example, if your installment plan is 12 months but your subscription service contract is 24 months, the 24 month installment plan will be used.
• If the subscription cost of your headline offer for your product increases after a certain period of time, then use the highest payment in the amount [amount] sub-attribute.
  • For example, if the subscription payment increases from 25 EUR to 35 EUR after 12 months, specify 35 EUR.

Examples