age_group [age_group]: Definition

Use the age_group [age_group] attribute to set the demographic that your product is designed for.

When you use this attribute, your ad can appear in results that are filtered by age. For example, if results are filtered by Women instead of Girls. The age_group [age_group] can also work together with the gender [gender] to help ensure that users see the correct size information.

An illustration showing a person shopping online and filtering clothing options by age group

When to use

Required for all products that vary by age

Required for all Clothing & 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 Clothing & Accessories sub-categories: 

  • Pinback Buttons (4179)
  • Cufflinks & Tie Clips (505946)
  • Wristbands (1893)
  • Shoe Covers (5385)
  • Shoelaces (1856)
  • Spurs (2427)
  • Watch Bands (5123)
  • Keychains (175)
  • Wallet Chains (5841)
  • Lanyards (6271)
  • Chequebook Covers (6460)
  • Badge & Pass Holders (6170)
  • Watch Winders (6870)
  • Watch Stickers & Decals (7471)
  • Loose Diamonds & Gemstones (531005)
  • Handkerchiefs (5207)
  • Decorative Fans (5114)

These are the supported values that 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 that we understand the data that you're submitting. 

Supported values newborn, infant, toddler, kids or adult
Repeated field No
 
File format Example entry
Text adult
XML <g:age_group>adult</g:age_group>

For format API information, please see Content API for Shopping.

Guidelines

Follow these guidelines to make sure that you submit high-quality data for your products and get the best performance from your ads.

  • 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 [age_group] 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 the item_group_id [item_group_id] attribute. 

Best practices

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

  • Submit the age group as adult [adult] for items that are not only for children. Submitting an age group as adult [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 [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 you ads for your products are shown with the right search results.

For example, these types of products can vary by age group:

  • Clothing
  • Games
  • Magazines
  • Bed Sheets
  • Blankets
  • Duvet Covers
  • Nap Mats
  • Pillowcases & Shams
  • Quilts & Duvets
  • Towels
  • Parasols & Rain Umbrellas
  • Pool Toys
  • Pool Floats & Loungers
  • Night Lights & Ambient Lighting
  • Piggy Banks & Money Jars
  • Rugs
  • Curtains & Drapes
  • Throw Pillows
  • Toys
  • Games

Sizes that vary by age group

To show users the correct size information, the age group is also used together with the gender [gender].

Product Tennis shoes
gender [gender] male
size [size] 7
size_system [size_system] GB
size_type [size_system] regular
age_group [age_group] adult
   
Product Tennis shoes
gender [gender] female
size [size] 6
size_system [size_system] GB
size_type [size_system] regular
age_group [age_group] adult
   
Product Tennis shoes
gender [gender] female
size [size] 6
size_system [size_system] GB
size_type [size_system] regular
age_group [age_group] toddler
   
Product Tennis shoes
gender [gender] female
size [size] 6
size_system [size_system] GB
size_type [size_system] regular
age_group [age_group] kids

Was this helpful?
How can we improve it?