age_group: Definition

Use the 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 can also work together with the 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 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
 
File format Example entry
Text adult
XML <g:age_group>adult</g:age_group>
Content API v2 (JSON) "ageGroup": "adult"
Content API v2 (XML) <age_group>adult</age_group>

Guidelines

Follow these guidelines to make sure 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 attribute. 

Best practices

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

  • Submit the age group as adult for items that are not only for children. Submitting an age group as 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 you ads for 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
Was this article helpful?
How can we improve it?