The popularity rank [popularity_rank] attribute indicates the popularity of your product, ranked as a percentage of total inventory. The higher the value, the better performing your product is compared to other products you're selling.
On this page
When to use
Optional for each product
Use this attribute to communicate how well your products are selling, like your latest best sellers, and help consumers make a more informed buying decision.
The popularity rank [popularity_rank] attribute can be used in all countries.
Format
Follow these formatting guidelines to make sure Google understands the data you're submitting. Learn more about how to submit attributes and attribute values.
| Type | Number, between 0.0 and 100.0 |
| Repeated field | No |
|
Schema.org property (What's this?) |
No |
| File format | Example value |
| Text (TSV or CSV) data sources | 95.5 |
| XML data sources | <g:popularity_rank>95.5</g:popularity_rank> |
| API data sources | To format your data in the Merchant API, check the Merchant API resource. |
Minimum requirements
These are the requirements you'll need to meet to provide a valid popularity rank for your product.
- Specify a number between 0 and 100. Use at most 1 decimal point.
- Don't add the percentage (%) sign.
- Specify an accurate ranking, reflecting how well your product is selling and correctly ranked against other products in your inventory.
Best practices
These best practices can help you to go beyond the basic requirements to optimise your product data for performance.
- Update the value of the attribute (for example, through a supplemental data source) when there is a substantial change in its popularity based on your recent sales.
Example
A best-selling smart watch
| Attribute | Value |
Title [title] |
Smart Watch XL super fast |
popularity_rank [popularity_rank] |
97.5 |
A relatively unpopular printer
| Attribute | Value |
Title [title] |
Last season's entry-level printer |
popularity_rank [popularity_rank] |
12.5 |