[subscription_cost]attribute are not eligible for cross-border trade and can only have one targeted country.
Use the subscription cost
[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
Optional for each productThis attribute is only available in certain countries:
- Africa: South Africa
- Asia-Pacific: Hong Kong, India, Japan, Malaysia, New Zealand, Singapore, South Korea, Taiwan, Thailand
- Europe: Austria, Belgium, Czechia, Denmark, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Norway, Poland, Portugal, Romania, Slovakia, Spain, Sweden, Switzerland, Turkey, United Kingdom
- Middle East: Israel, Saudi Arabia, United Arab Emirates
- North America: Canada
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)
[price]attribute to specify the minimum total cost ("Minimum Quantifiable Price") of the device, including the down payment, installment payments, and wireless subscription plan. Use the title
[title]attribute to indicate that the device is payable in installments and if it comes with a wireless plan.
This attribute uses 3 sub-attributes:
[period](Required): The duration of a single subscription period. Either month
- Period length
[period_length](Required): Integer, the number of subscription periods (months or years) that the buyer must pay.
[amount](Required): ISO 4217, the amount the buyer must pay per month. When displaying this amount, we may round up to the nearest whole unit of local currency to save space. The provided value must still 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.
Follow these formatting guidelines to make sure Google understands the data you're submitting.
|Type||Unicode characters (Recommended: ASCII only)|
|File format||Example entry|
To format your data for Content API, see the Content API for Shopping resource.
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.
- Submit the price attribute with the total amount due at checkout (including down payment and activation fee) for the product.
- 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 price
- 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.
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 we will round the submitted value. Use the same currency for subscription cost
[installment], and price
- If the product is also paid for in monthly installments, use the same number of months for the subscription cost
[subscription_cost]as for the installments.
- If your product has installment payments, submit the same number of months for the subscription cost
[subscription_cost]attribute as for the installment
[installment]attribute. If the number of months is different and we need to combine your installment and subscription cost due to space constraints, then we use the highest of the two values. For example, if your installment plan is 12 months, but your subscription service contract is 24, then we will use 24 months.
- If the subscription cost for your product increases after a certain period of time then you must 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 then specify 35 EUR.
Mobile phone, sold with a subscription plan
Submit a total value for the down payment in the price
[price] attribute (as low as 0) and include any activation fees and/or one-time charges. Specify in your title that your wireless product requires a contract of a certain duration. Leave the installment
[installment] attribute empty.
|Product data for a Google Pixel 5” 32GB Very Silver with a 12-month service contract, of 35 EUR per month, and a down payment of 649 EUR|
||Google Pixel 5” 32GB Very Silver (with contract)|
||(Must be empty because there are no installment payments)|
|Google product category
Mobile phone sold in installments and bundled with a subscription plan
Submit a total value for the down payment (as low as 0) in the price
[price] attribute and include any activation fees and/or one-time charges. Submit zero in the price
[price] attribute if there are no up-front costs. Specify in your title that your wireless product requires a contract of a certain duration and an installment plan.
|Product data for a Google Pixel 5” 32GB Very Silver with 12-month contract and paid in 12 monthly installments|
||Google Pixel 5” 32GB Very Silver (with contract and 12 installment payments)|
|Google product category