Use the size
attribute to describe the standardized size of your product. When you use this attribute, your product can appear in results that are filtered by size. The size you submit will also affect how your product variants are shown.
When to use
Required for enhanced free listings for all Apparel & Accessories > Clothing
(1604
) and Apparel & Accessories > Shoes
(187
) products
Required for Shopping ads for Apparel & Accessories > Clothing
(1604
) and Apparel & Accessories > Shoes
(187
) products when targeting these countries:
- Brazil
- France
- Germany
- Japan
- United Kingdom
- United States
Format
Follow these formatting guidelines to make sure we understand the data you're submitting.
Type | String (Unicode characters. Recommended: ASCII only) |
---|---|
Limits | 1–100 characters |
Repeated field | No |
Schema.org property (What’s this?) |
Product.size, Type: Text |
File format | Example value |
---|---|
Text feeds | XL |
XML feeds | <g:size>XL</g:size> |
To format your data for Content API, see the Content API for Shopping.
Minimum requirements
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 the Diagnostics page in your Merchant Center account.
- Use a standard size value for your country of sale. Learn more about what types of values are recognized
- Submit only one attribute per product. If you provide multiple size attributes for the same product, only the first will be applied. Additional size attributes will be discarded, and you will receive a warning.
- Submit only the size value. Don’t submit values such as n/a, none, or multisize. Make sure to submit non-size information through the correct attribute such as
color
,material
, andpattern
. - Submit
size
for all products that vary by size.- For apparel products, use this attribute when your product is a variant that’s distinguished by its size. For example, use “S” as the value for a small red T-shirt and use “L” as the value for a large red T-shirt. Also submit each variant as a separate product with the same value for the
item_group_id
attribute. Don’t submit multiple sizes separated by a comma (,
). Instead, use a slash. For example, enter small/medium/large (and not small, medium, large). - For products with multiple dimensions, don’t submit multiple sizes separated by a comma ( , ). Instead, condense multiple dimensions into one size value using a slash. For example, enter 16/34 to represent a neck size of 16 inches and a sleeve length of 34 inches.
- For non-apparel products, submit the relevant size. Sizes for different types of products vary widely, but providing this information can help ensure that your product is shown to the right users.
- For apparel products, use this attribute when your product is a variant that’s distinguished by its size. For example, use “S” as the value for a small red T-shirt and use “L” as the value for a large red T-shirt. Also submit each variant as a separate product with the same value for the
Best practices
These best practices can help you go beyond the basic requirements to optimize your product data for performance.
- Provide values that your users will understand. The values that you provide could be shown to users, so make sure that values you submit can be understood by your users.
- Use a consistent format for size. For example, imagine you’re selling a shirt that comes in small, medium, and large. For those variants, submit S, M, and L. Don’t submit S, Medium, and Lrg. The size that you submit is standardized before it’s shown to users. By submitting consistent sizes, you can help ensure that the size is standardized correctly.
- Provide more size details using the other size attributes. Provide the cut of your garment using
size_type
. Indicate the country convention for your size withsize_system
. - Submit the complete size of your product. If your product size has several components, make sure to submit all of this information. Otherwise, the size could be misunderstood, and it might not be standardized or shown to the correct users. For example, if you sell shoes in different widths, you should specify the width in the
size
attribute. So, instead of just submitting size 8, you'd submit size 8 N to represent 8 narrow. - For retailer-defined multipack products, please submit the multipack quantity using the
multipack
attribute. Do not submit the multipack quantity undersize
.
Additional guidelines
Review each section closely to determine if the requirements apply to your country or product. If you don't follow requirements that apply to you, we'll disapprove your product and let you know in Diagnostics in your Merchant Center account.
Standard sizes (all countries and apparel categories)
Supported values | Examples |
---|---|
One size fits all |
|
Small, medium, and large sizes (including ranges): XXS , XS , S , M , L , XL , 2XL , 3XL , 4XL , 5XL , 6XL |
|
Baby sizing in months, including ranges |
|
Size followed by toddler |
|
General numeric sizes, including fractional sizes (standard ranges for specific countries and categories): 000 –100 |
|
Standard number ranges (all countries and categories)
Countries | Category | Systems | Number range |
---|---|---|---|
BR | Coats and jackets | BR |
|
AT, BE, CH, CZ, DE, DK, ES, FR, IT, NL, NO, PL, RU, SE, TR | Coats and jackets | DE, EU, FR, IT |
|
AU, GB, IN | Coats and jackets | UK |
|
CA, US | Coats and jackets | US |
|
BR | Dresses and jackets | BR |
|
AT, AU, BE, CA, CH, CZ, DE, DK, ES, FR, GB, IN, IT, NL, NO, PL, RU, SE, TR, US | Dresses and jackets | DE, EU, FR, IT |
|
AT, AU, BE, CA, CH, CZ, DE, DK, ES, FR, GB, IN, IT, NL, NO, PL, RU, SE, TR, US | Dresses and jackets | UK, US |
|
CA, US | Jewelry | US |
|
AT, AU, BE, BR, CA, CH, CZ, DE, DK, ES, FR, GB, IN, IT, NL, NO, PL, RU, SE, TR, US | Pants (inseam) | Use the common system of each country |
|
AT, AU, BE, CA, CH, CZ, DE, DK, ES, FR, GB, IN, IT, NL, NO, PL, RU, SE, TR, US | Pants and shorts (waist) | Use the common system of each country |
|
BR | Shirts and tops | BR |
|
AT, AU, BE, CA, CH, CZ, DE, DK, ES, FR, GB, IN, IT, NL, NO, PL, RU, SE, TR, US | Shirts and tops | DE, EU, FR, IT |
|
AT, AU, BE, CA, CH, CZ, DE, DK, ES, FR, GB, IN, IT, NL, NO, PL, RU, SE, TR, US | Shirts and tops | US |
|
AT, AU, BE, CA, CH, CZ, DE, DK, ES, FR, GB, IN, IT, NL, NO, PL, RU, SE, TR, US | Shirts and tops | UK |
|
BR | Shoes | BR |
|
AT, AU, BE, CA, CH, CZ, DE, DK, ES, FR, GB, IN, IT, NL, NO, PL, RU, SE, TR, US | Shoes | US |
|
AT, AU, BE, CA, CH, CZ, DE, DK, ES, FR, GB, IN, IT, NL, NO, PL, RU, SE, TR, US | Shoes | UK |
|
AT, AU, BE, BR, CA, CH, CZ, DE, DK, ES, FR, GB, IN, IT, NL, NO, PL, RU, SE, TR, US | Shoes | EU |
|
BR | Underwear and swimwear | BR |
|
AT, BE, CH, CZ, DE, DK, ES, FR, IT, NL, NO, PL, RU, SE, TR | Underwear and swimwear | DE, EU, FR, IT |
|
AU, GB, IN | Underwear and swimwear | UK |
|
CA, US | Underwear and swimwear | US |
|
Other countries | Other categories | Use the common system of each country |
|
Shoes
Depending on your country of sale, you can submit a numeric size value for shoes plus a width measurement.
Available for all countries of sale
Supported values | Examples |
---|---|
Shoe width: XXN (extra extra narrow), XN , N , M (medium), W (wide), XW , XXW |
|
Available only for the United States and Canada
Supported values | Examples |
---|---|
Shoe letter width: 4A , 3A , 2A , A , B , C , D , E , 2E , 3E , 4E , 5E , 6E |
|
Pants
You can submit a numeric size value plus an additional word of description. If you need to add an additional word of description to clarify the size, we recommend that you submit the value in English.
Supported values | Examples |
---|---|
Inseams using numbers or one of the following size types: x-short , short , regular , long , x-long |
|
Coats and jackets
You can submit a numeric size value plus an additional word of description. If you need to add an additional word of description to clarify the size, we recommend that you submit the value in English.
Supported values | Examples |
---|---|
short , regular , long |
|
Underwear and swimwear
You can submit a numeric size value plus an additional cup measurement.
Supported values | Examples |
---|---|
Letter cup sizes |
|
Baby and toddler (US only)
You can submit a numeric size value plus an additional word of description. If you need to add an additional word of description to clarify the size, we recommend that you submit the value in English.
Supported values | Examples |
---|---|
preemie , newborn |
|
Jewelry (UK only)
You can submit a letter size value plus a quarter or half size measurement.
Supported values | Examples |
---|---|
Letter sizes A –Z followed by optional quarter and half sizes |
|
Examples
Apparel products
Apparel products often vary by size. Use the same item_group_id
for each variant. Here’s an example that comes in 2 colors, each in 3 sizes. For this example, you’d submit these 6 variants:
Product | Google logo T-shirt |
title |
Google Logo T-shirt - Small - White |
id |
12345-S-W |
color |
white |
size |
S |
item_group_id |
12345 |
Product | Google logo T-shirt |
title |
Google Logo T-shirt - Small - Black |
id |
12345-S-B |
color |
black |
size |
S |
item_group_id |
12345 |
Product | Google logo T-shirt |
title |
Google Logo T-shirt - Medium - White |
id |
12345-M-W |
color |
white |
size |
M |
item_group_id |
12345 |
Product | Google logo T-shirt |
title |
Google Logo T-shirt - Medium - Black |
id |
12345-M-B |
color |
black |
size |
M |
item_group_id |
12345 |
Product | Google logo T-shirt |
title |
Google Logo T-shirt - Large - White |
id |
12345-L-W |
color |
white |
size |
L |
item_group_id |
12345 |
Product | Google logo T-shirt |
title |
Google Logo T-shirt - Large - Black |
id |
12345-L-B |
color |
black |
size |
L |
item_group_id |
12345 |
Sizes with multiple dimensions
Some sizes are made up of multiple dimensions, such as 16/34 Tall, which means neck size 16 inches, sleeve length 34 inches, and tall fit. In these cases, make sure you submit all of these details as one value.
Product | Android logo shirt |
---|---|
size |
16/34 Tall |
size_system |
US |
title |
Android logo shirt, 16/34 Tall |
id |
3131-16_34-tall |
item_group_id |
3131 |
Apparel with a specific cut
If your product fits into a specific size group, like petite, oversize, or maternity, then submit the size_type
attribute.
If your product has a different inseam length, then submit that with the size
attribute.
Product | Android logo jacket |
---|---|
size |
xl |
size_type |
oversize |
title |
Android logo jacket, Size XL, Oversize, Black |
id |
4567-xlb-blk |
item_group_id |
4567 |
Product | Android logo jacket |
---|---|
size |
xl |
size_type |
regular |
title |
Android logo jacket, Size XL, Black |
id |
4567-ml-blk |
item_group_id |
4567 |
Shoes
Make sure to submit all details that affect the size of your product. The actual size for shoes, like many apparel products, is based on several attributes, including size
, gender
, and size_system
.
Product | Running shoes |
---|---|
size |
8.5 |
size_system |
US |
gender |
male |
title |
Google Running Shoes, Mens 8.5 US |
id |
09876-8_5-M-US |
item_group_id |
09876 |
Product | Running shoes |
---|---|
size |
9 |
size_system |
US |
gender |
female |
title |
Google Running Shoes, Womens 9 US |
id |
09876-9-W-US |
item_group_id |
09876 |
Jewelry
Jewelry often comes in many different sizes. The size that’s displayed to users is often based on many different attributes, including size
and size_system
.
Product | White gold wedding band |
---|---|
size |
41½ |
size_system |
FR |
title |
White Gold Wedding Band - 14K - 41½ |
color |
white gold |
material |
white gold |
id |
909090-41_5 |
item_group_id |
909090 |
Art prints
The sizes for non-apparel products often aren’t standardized, so if your product comes in multiple sizes, such as with art prints, still submit each variant as a separate product, but use the same item_group_id
.
Product | Android logo print |
---|---|
size |
16x12 in |
title |
Android Logo Print - 16x12 in |
id |
232323-16x12 |
item_group_id |
232323 |
Perfume
The sizes for non-apparel products often aren’t standardized, so if your product comes in multiple sizes, such as with perfume, still submit each variant as a separate product, but use the same item_group_id
.
Product | Petites fleurs eau de toilette |
---|---|
size |
3.4 fl oz |
size_system |
US |
title |
Petites Fleurs Eau de Toilette Spray - 3.4 fl oz bottle |
id |
454545-3_4floz |
item_group_id |
454545 |
Mobile phone storage
The sizes for non-apparel products often aren’t standardized, so if your product comes in multiple sizes, such as with mobile phone storage, still submit each variant as a separate product, but use the same item_group_id
.
Product | Google Pixel 3 |
title |
Google Pixel 3 - 16 GB - Midnight Blue - unlocked |
id |
676767-16gb |
color |
midnight blue |
size |
16 GB |
item_group_id |
676767 |
Product | Google Pixel 3 |
title |
Google Pixel 3 - 32 GB - Midnight Blue - unlocked |
id |
676767-32gb |
color |
midnight blue |
size |
32 GB |
item_group_id |
676767 |