Use the age_group
attribute to set the demographic that your product is designed for.
When you use this attribute, your product can appear in results that are filtered by age. For example, if results are filtered by Women instead of Girls. The age_group
attribute can also work together with the gender
attribute to help ensure that users see the correct size information.
When to use
Required for enhanced free listings for all Apparel & Accessories
(166
) products.
Required for Shopping ads for all Apparel & Accessories
(166
) products when targeting these countries:
- Brazil
- France
- Germany
- Japan
- The United Kingdom
- The United States
Optional but not required for products in the following Apparel & Accessories
sub-categories:
Pinback Buttons
(4179
)Tie Clips
(180
)Cufflinks
(193
)Wristbands
(1893
)Shoe Covers
(5385
)Shoelaces
(1856
)Spurs
(2427
)Watch Bands
(5123
)Keychains
(175
)Wallet Chains
(5841
)Lanyards
(6277
)Checkbook Covers
(6460
)Badge & Pass Holders
(6170
)Watch Winders
(6870
)Watch Stickers & Decals
(7471
)Handkerchiefs
(5207
)Decorative Fans
(5114
)
These are the supported values you can choose from:
newborn
Up to 3 months old. Newborn sizes are often identified by the age range in months (0–3) or just “newborn.”infant
3–12 months old. Infant sizes are often identified by the age range in months (3–12).toddler
1–5 years old. Toddler sizes are often identified by the age range in months (12–24) or years (1–5).kids
5–13 years old. All sizes within this age group have been manufactured to fit a child in that age range.adult
Typically teens or older. All sizes within this age group have been manufactured to fit an adult or teen.
Format
Follow these formatting guidelines to make sure we understand the data you're submitting.
Supported values | newborn , infant , toddler , kids , or adult |
---|---|
Repeated field | No |
Schema.org property (What’s this?) |
Product.audience.suggestedMinAge , Product.audience.suggestedMaxAge Type: Number. Only use the defined age ranges for each supported value. Age is expressed in years so, for example, use 0.25 for 3 months. |
File format | Example entry |
---|---|
Text | adult |
XML feeds | <g:age_group>adult</g:age_group> |
To format your data for Content API, see the Content API for Shopping.
- Submit one of the supported values if this attribute is required for your target country and product category. This attribute doesn't have a default value, so if you don't submit it, no value will be used.
- Submit an accurate
age_group
attribute for all products that vary by age group. Use this attribute when your product is a variant that’s distinguished by its age group (e.g., shoes for 0–3 months and shoes for 1–5 years), and also submit each variant with the same value for theitem_group_id
attribute.
Best practices
These best practices can help you go beyond the basic requirements to optimize your product data for performance.
- Submit the age group with the value “adult” for items that are not exclusively for children. Submitting an age group with the value “adult” won't limit the search results that your product can appear for, and it doesn't mean that your product contains sexually suggestive content. If your product does contain sexually suggestive content, then use the
adult
attribute. - Submit an accurate age group if your product varies by age, even if it is not a variant. If your product does vary by age group, submitting the correct age group will help ensure that your product is shown in the correct situations such as search results filtered by age.
Examples
Products that vary by age group
Many products vary by age, and adding an age group can help ensure that your products are shown with the right search results.
For example, these types of products can vary by age group:
- Apparel
- Games
- Books
- Bed Sheets
- Blankets
- Duvet Covers
- Nap Mats
- Pillowcases & Shams
- Quilts & Comforters
- Towels
- Parasols & Rain Umbrellas
- Pool Toys
- Pool Floats & Loungers
- Night Lights & Ambient Lighting
- Piggy Banks & Money Jars
- Rugs
- Curtains & Drapes
- Throw Pillows
- Toys
Sizes that vary by age group
To show users the correct size information, the age group is also used together with the gender
.
Product | Tennis shoes |
gender |
male |
size |
6 |
size_system |
US |
size_type |
regular |
age_group |
adult |
Product | Tennis shoes |
gender |
female |
size |
6 |
size_system |
US |
size_type |
regular |
age_group |
adult |
Product | Tennis shoes |
gender |
female |
size |
6 |
size_system |
US |
size_type |
regular |
age_group |
toddler |
Product | Tennis shoes |
gender |
female |
size |
6 |
size_system |
US |
size_type |
regular |
age_group |
kids |