What type of values are expected for specific attributes in metafields ?
Different attributes require different format. If your values do not follow a certain expected format, the data might not be pushed to GMC.
While creating metafields, it is important to know their type and format. This will help you push information to GMC without any errors. Please note that the format is case sensitive and refer to the respective attribute documentation if more information is required.
| Metafield Definition - Type | Metafield Attribute | Expected Format | Example |
|---|---|---|---|
| Single line text | Additional Image Links | URL1, URL2 | https://www.example.com/image2.jpg, https://www.example.com/image3.jpg |
| Single line text | Ads redirect | URL (including http or https) | https://tracking.example.com?product=ballpoint-pens |
| Single line text | Age group | Supported values : newborn, infant, toddler, kids, adult. | adult |
| Single line text | Availability | Supported values : in_stock, out_of_stock, preorder, backorder.Note : preorder attribute requires [availability_date] attribute. | in_stock |
| Date | Availability date | Date, time, and timezone. (YYYY-MM-DDThh:mm[±hhmm], or YYYY-MM-DDThh:mmZ) | 2016-12-25T13:00-0800 |
| Single line text | Brand | String | Adnabu |
| Single line text | Canonical Link | URL (including http or https) | http://www.example.com/writing/google-pens |
| Single line text | Color | String | Purple |
| Single line text | Condition | Supported values : new, refurbished, used. Note : required when product is used or refurbished. | refurbished |
| Money | Cost of goods sold | Number + currency | 10.00 USD |
| Single line text | Custom label 0–4 | String | tropical |
| Multi-line text | Description | String | Google Chromecast was designed to discreetly connect to your TV. |
| Single line text | Energy efficiency class | Supported values : A+++, A++, A+, A, B. C. D, E, F, G | A+ |
| Date | Expiration date | Date, time, and timezone. (YYYY-MM-DDThh:mm[±hhmm], or YYYY-MM-DDThh:mmZ) | 2016-02-24T00:30-0800 |
| Single line text | GTIN | Number with 0,8,12,13 or 14 digits | 3234567890126 |
| Single line text | Google product category | Predefined IDs or full path | 2271 or Apparel & Accessories > Clothing > Dresses |
| Single line text | Installment | installment(months:amount:downpayment) | 6:50 EUR:200 EUR |
| Single line text | Adult | Supported values :yes, true, no, false | yes |
| Single line text | Bundle | Supported values :yes, true,. no, false | yes |
| Single line text | MPN | String | GO12345OOGLE |
| Single line text | Material | Unicode characters | Leather |
| Single line text | Maximum handling time, minimum handling time | Number | 4 |
| Single line text | Mobile link | URL | https://www.m.example.com/writing/fiji-pens |
| Single line text | Multipack | Number | 7 |
| Single line text | Pattern | Unicode characters | Striped |
| Money | Price | Number + currency | 15.00 USD |
| JSON | Product detail | String | |
| Dimension | Product length width, height | product length: cm, inproduct width: cm, inproduct height: cm, in | 20 in40 in10 in |
| Weight | Product weight | product weight: lb, oz, g, kg | 3.5 lb |
| Single line text | Product highlight | String | "highlight1", "highlight2" |
| Single line text | Product type | String | Home > Women > Dresses > Maxi Dresses |
| Money | Sale price | Number + currency | 15.00 USD |
| Date | Sale price effective date | Date range with start date and end date with time and timezone separated with "/" | 2016-02-24T13:00-0800/2016-02-29T15:30-0800 |
| Single line text | Shipping | Unicode charactersshipping(country:postal_code:price:min_handling_time:max_handling_time:min_transit_time:max_transit_time) | US:80302:6.49 |
| Dimension | Shipping length width, height | Number + dimension unit (cm, inch) | 20 in |
| Single line text | Shipping label | Unicode characters | Oversized |
| Weight | Shipping weight | Number + unit (lb, oz, g, kg) | 3 kg |
| Single line text | Excluded countries for Shopping ads | String, 2 characters country code | CH, AT |
| Single line text | Size | String | XL |
| Single line text | Size system | Supported values : AU, BR, CN, DE, EU, FR, IT, JPMEX, UK, US | US |
| Single line text | Subscription cost | [period]:[preiod_length][amount]Period : month, year | month:12:50 EUR |
| Single line text | Tax category | String | apparel |
| Single line text | Title | String | Organic Cotton Men's T-Shirt |
| Unit pricing base measure | Number + unitWeight: oz, lb, mg, g, kgVolume (US imperial): floz, pt, qt, galVolume (metric): ml, cl, l, cbmLength: in, ft, yd, cm, mArea: sqft, sqmPer unit: ct, sheet, item | 100oz | |
| Unit pricing measure | Number + unitWeight: oz, lb, mg, g, kgVolume (US imperial): floz, pt, qt, galVolume (metric): ml, cl, l, cbmLength: in, ft, yd, cm, mArea: sqft, sqmPer unit: ct, sheet, item | 750ml | |
| Single line text | Promotion IDs | String | all_lamps_must_go |
Updated on: 11/03/2025
Thank you!