Supported Product Attribute
Catalog Management API
Supported List
Examples provided for attributes are not a completed list. If there are values not captured in the examples or data fields you think is valuable to share with us, please feel free to share it directly in the product attributes.
| Category | Attribute Name | Type | Description | Examples |
|---|---|---|---|---|
| Alcohol Properties | alcohol_vintage | number | Vintage refers to the year a wine was produced. | 2018, 2019, 2020, etc. |
| alcohol_body | string | Body refers to how the beverage feels in your mouth, including its weight, texture, and richness. Typically only applies to Wine and Spirits. | ALCOHOL_BODY_LIGHT_BODIED, ALCOHOL_BODY_MEDIUM_BODIED, ALCOHOL_BODY_FULL_BODIED | |
| alcohol_by_volume | number | The ABV (Alcohol by Volume) is the percentage of alcohol in the beverage. It may be displayed as Proof (typically applied to Spirits), which is expressed in a whole number (18% ABV = 36 Proof) | 5, 7, 13, 20, etc. | |
| alcohol_dry_sweetness_level | string | Sweetness / Dryness Level refers to the amount of residual sugar retained from the grapes during the fermentation process. | EXTRA DRY, DRY, OFF-DRY, SEMI-SWEET, SWEET, VERY SWEET | |
| alcohol_beer_segment | string | Describes the segment of the industry | Lager, IPA, Stout, Pilsner | |
| alcohol_food_pairing | string | Food pairing refers to food that pairs well with the alcoholic beverage. | BEEF, POULTRY, FISH, SHELLFISH, SOFT CHEESE, HARD SHEESE, SPICY, PORK, DESSERTS, LAMB, SEAFOOD, CHIPS, PASTA, VEGETABLES | |
| alcohol_appellation | string | Appellation refers to the larger geographical area the wine is grown. Does not include city, state, or country. | APPELLATION_SOUTH_AUSTRALIA, APPELLATION_ALSACE, APPELLATION_BORDEAUX, APPELLATION_BURGUNDY, APPELLATION_CHAMPAGNE, APPELLATION_MOSEL, APPELLATION_LOMBARDY, APPELLATION_SICILY, APPELLATION_VENETO, APPELLATION_WESTERN_CAPE, APPELLATION_ANDALUCIA, APPELLATION_LA_RIOJA, APPELLATION_NAPA_VALLEY, APPELLATION_SONOMA_VALLEY, APPELLATION_PASO_ROBLES, APPELLATION_ALEXANDER_VALLEY, APPELLATION_AMADOR_COUNTY, APPELLATION_ANDERSON_VALLEY, APPELLATION_ARROYO_SECO, APPELLATION_ATLAS_PEAK, APPELLATION_BERGERAC, APPELLATION_CALISTOGA, APPELLATION_CHALK_HILL, APPELLATION_CHEHALEM_MOUNTAINS, APPELLATION_MENDOZA, APPELLATION_COOMBSVILLE, APPELLATION_DIAMOND_MOUNTAIN, APPELLATION_DRY_CREEK_VALLEY, APPELLATION_DUNDEE_HILLS, APPELLATION_EDNA_VALLEY, APPELLATION_EL_DORADO, APPELLATION_EOLA_AMITY_HILLS, APPELLATION_GREEN_VALLEY, APPELLATION_HORSE_HEAVEN_HILLS, APPELLATION_HOWELL_MOUNTAIN, APPELLATION_KNIGHTS_VALLEY, APPELLATION_MCMINNVILLE, APPELLATION_OAK_KNOLL, APPELLATION_OAKVILLE, APPELLATION_PESSAC_LEOGNAN, APPELLATION_PLACER_COUNTY, APPELLATION_RED_MOUNTAIN, APPELLATION_RIBBON_RIDGE, , APPELLATION_RUSSIAN_RIVER_VALLEY, APPELLATION_RUTHERFORD, APPELLATION_SAN_ANTONIO_VALLEY, APPELLATION_SAN_LUIS_OBISPO, APPELLATION_SANTA_CRUZ_MOUNTAINS, APPELLATION_SANTA_LUCIA_HIGHLANDS, APPELLATION_SANTA_MARIA_VALLEY, APPELLATION_SANTA_RITA_HILLS, APPELLATION_SANTA_YNEZ, APPELLATION_SONOMA_COAST, APPELLATION_SONOMA_MOUNTAIN, APPELLATION_SPRING_MOUNTAIN, APPELLATION_STAGS_LEAP_DISTRICT, APPELLATION_WAHLUKE_SLOPE, APPELLATION_WALLA_WALLA, APPELLATION_YAMHILL_CARLTON, APPELLATION_YORK_MOUNTAIN | |
| alcohol_region_of_origin | string | Origin refers to the country, state, city of the product is produced. | REGION_OF_ORIGIN_WYOMING, REGION_OF_ORIGIN_ALASKA, REGION_OF_ORIGIN_ALGERIA, REGION_OF_ORIGIN_ARGENTINA, REGION_OF_ORIGIN_ARIZONA, REGION_OF_ORIGIN_ARKANSAS, REGION_OF_ORIGIN_ARMENIA, REGION_OF_ORIGIN_AUSTRALIA, REGION_OF_ORIGIN_AUSTRIA, REGION_OF_ORIGIN_BRAZIL, REGION_OF_ORIGIN_BULGARIA, REGION_OF_ORIGIN_CALIFORNIA, REGION_OF_ORIGIN_CANADA, REGION_OF_ORIGIN_CHILE, REGION_OF_ORIGIN_CHINA, REGION_OF_ORIGIN_COLORADO, REGION_OF_ORIGIN_CONNECTICUT, REGION_OF_ORIGIN_CROATIA, REGION_OF_ORIGIN_CYPRUS, REGION_OF_ORIGIN_CZECH_REPUBLIC, REGION_OF_ORIGIN_DELAWARE, REGION_OF_ORIGIN_DENMARK, REGION_OF_ORIGIN_ECUADOR, REGION_OF_ORIGIN_ENGLAND, REGION_OF_ORIGIN_FINLAND, REGION_OF_ORIGIN_FLORIDA, REGION_OF_ORIGIN_FRANCE, REGION_OF_ORIGIN_GEORGIA_REPUBLIC, REGION_OF_ORIGIN_GEORGIA_STATE, REGION_OF_ORIGIN_GERMANY, REGION_OF_ORIGIN_GLOBAL, REGION_OF_ORIGIN_GREECE, REGION_OF_ORIGIN_HAWAII, REGION_OF_ORIGIN_HUNGARY, REGION_OF_ORIGIN_IDAHO, REGION_OF_ORIGIN_ILLINOIS, REGION_OF_ORIGIN_INDIA, REGION_OF_ORIGIN_INDIANA, REGION_OF_ORIGIN_IOWA, REGION_OF_ORIGIN_IRELAND, REGION_OF_ORIGIN_ISRAEL, REGION_OF_ORIGIN_ITALY, REGION_OF_ORIGIN_JAMAICA, REGION_OF_ORIGIN_JAPAN, REGION_OF_ORIGIN_KANSAS, REGION_OF_ORIGIN_KENTUCKY, REGION_OF_ORIGIN_KOREA, REGION_OF_ORIGIN_LEBANON, REGION_OF_ORIGIN_LOUISIANA, REGION_OF_ORIGIN_MACEDONIA, REGION_OF_ORIGIN_MAINE, REGION_OF_ORIGIN_MARYLAND, REGION_OF_ORIGIN_MASSACHUSETTS, REGION_OF_ORIGIN_MEXICO, REGION_OF_ORIGIN_MICHIGAN, REGION_OF_ORIGIN_MINNESOTA, REGION_OF_ORIGIN_MISSISSIPPI, REGION_OF_ORIGIN_MISSOURI, REGION_OF_ORIGIN_MOLDOVA, REGION_OF_ORIGIN_MONTANA, REGION_OF_ORIGIN_MONTENEGRO, REGION_OF_ORIGIN_MOROCCO, REGION_OF_ORIGIN_NEBRASKA, REGION_OF_ORIGIN_NETHERLANDS, REGION_OF_ORIGIN_NEVADA, REGION_OF_ORIGIN_NEW_HAMPSHIRE, REGION_OF_ORIGIN_NEW_JERSEY, REGION_OF_ORIGIN_NEW_MEXICO, REGION_OF_ORIGIN_NEW_YORK, REGION_OF_ORIGIN_NEW_ZEALAND, REGION_OF_ORIGIN_NORTH_CAROLINA, REGION_OF_ORIGIN_OHIO, REGION_OF_ORIGIN_OREGON, REGION_OF_ORIGIN_PENNSYLVANIA, REGION_OF_ORIGIN_PERU, REGION_OF_ORIGIN_POLAND, REGION_OF_ORIGIN_PORTUGAL, REGION_OF_ORIGIN_RHODE_ISLAND, REGION_OF_ORIGIN_ROMANIA, REGION_OF_ORIGIN_RUSSIA, REGION_OF_ORIGIN_SCOTLAND, REGION_OF_ORIGIN_SERBIA, REGION_OF_ORIGIN_SLOVENIA, REGION_OF_ORIGIN_SOUTH_AFRICA, REGION_OF_ORIGIN_SOUTH_CAROLINA, REGION_OF_ORIGIN_SOUTH_DAKOTA, REGION_OF_ORIGIN_SOUTH_KOREA, REGION_OF_ORIGIN_SPAIN, REGION_OF_ORIGIN_SWITZERLAND, REGION_OF_ORIGIN_TENNESSEE, REGION_OF_ORIGIN_TEXAS, REGION_OF_ORIGIN_TURKEY, REGION_OF_ORIGIN_UKRAINE, REGION_OF_ORIGIN_UNITED_STATES, REGION_OF_ORIGIN_URUGUAY, REGION_OF_ORIGIN_VENEZUELA, REGION_OF_ORIGIN_VIRGINIA, REGION_OF_ORIGIN_WASHINGTON, REGION_OF_ORIGIN_WISCONSIN, REGION_OF_ORIGIN_ALABAMA | |
| alcohol_varietal | string | Varietal refers to a wine that is made from a single grape variety and bears the name of that grape. For a wine to be considered varietal, it has to contain at least 85% of the wine grape listed on its label (75% in the USA). If to contains two or more different grapes, it is a blended wine. | ALCOHOL_VARIETAL_ARNEIS, ALCOHOL_VARIETAL_CABERNET_SAUVIGNON, ALCOHOL_VARIETAL_CHENIN_BLANC, ALCOHOL_VARIETAL_GRENACHE, ALCOHOL_VARIETAL_MOURVEDRE, ALCOHOL_VARIETAL_PINOT_BLANC, ALCOHOL_VARIETAL_RIESLING, ALCOHOL_VARIETAL_SHIRAZ_SYRAH, ALCOHOL_VARIETAL_ZINFANDEL, ALCOHOL_VARIETAL_BARBERA, ALCOHOL_VARIETAL_CARIGNAN, ALCOHOL_VARIETAL_DOLCETTO, ALCOHOL_VARIETAL_MALBEC, ALCOHOL_VARIETAL_MUSCAT, ALCOHOL_VARIETAL_PINO_GRIGIO, ALCOHOL_VARIETAL_SANGIOVESE, ALCOHOL_VARIETAL_TEMPRANILLO, ALCOHOL_VARIETAL_BRUNELLO, ALCOHOL_VARIETAL_CHARBONO, ALCOHOL_VARIETAL_GAMAY, ALCOHOL_VARIETAL_MARSANNE, ALCOHOL_VARIETAL_NEBBIOLO, ALCOHOL_VARIETAL_PINOR_NOIR, ALCOHOL_VARIETAL_SAUVIGNON_BLANC, ALCOHOL_VARIETAL_CABERNET_FRANC, ALCOHOL_VARIETAL_CHARDONNAY, ALCOHOL_VARIETAL_GEWURZTRAMINER, ALCOHOL_VARIETAL_MERLOT, ALCOHOL_VARIETAL_PETITE_SIRAH, ALCOHOL_VARIETAL_PRIMITIVO, ALCOHOL_VARIETAL_SEMILLON, ALCOHOL_VARIETAL_VIOGNIER, ALCOHOL_VARIETAL_PROSECCO, ALCOHOL_VARIETAL_MOSCATO, ALCOHOL_VARIETAL_CHAMPAGNE, ALCOHOL_VARIETAL_SANGRIA, ALCOHOL_VARIETAL_RED_BLEND, ALCOHOL_VARIETAL_WHITE_BLEND, ALCOHOL_VARIETAL_ROSE, ALCOHOL_VARIETAL_ROSE_CHAMPAGNE, ALCOHOL_VARIETAL_BORDEAUX, ALCOHOL_VARIETAL_CHIANTI, ALCOHOL_VARIETAL_SHERRY, ALCOHOL_VARIETAL_PORT, ALCOHOL_VARIETAL_DESSERT_WINES, ALCOHOL_VARIETAL_OTHER_REDS, ALCOHOL_VARIETAL_NON_ALCOHOLIC_WINE, ALCOHOL_VARIETAL_OTHER_WHITES, ALCOHOL_VARIETAL_SPARKLING_WINE, ALCOHOL_VARIETAL_VERMOUTH | |
| alcohol_accolade_rating | number | Accolade Rating refers to the value given with the accolade or award. | 90 points, 4 stars | |
| alcohol_accolade_reviewer | string | Accolades are an award or recognition of excellence. Accolade Reviewer refers to the body or organization that is given the accolade or award. | Wine Enthusiast, CNET, James Beard Foundation | |
| alcohol_accolades_text | string | Accolade Text is the additional information about the accolade or award. | Winner of Best New Product 2023 | |
| alcohol_review_year | string | The year in which the alcohol product was reviewed or received a rating. | 2021, 2023 | |
| alcohol_wine_style | string | The style or variety of wine, such as "Red, " "White, " "Sparkling, " or "Rosé." | WINE_STYLE_CRISP, WINE_STYLE_ELEGANT, WINE_STYLE_FRESH, WINE_STYLE_FRUITY, WINE_STYLE_REFINED, WINE_STYLE_COMPLEX, WINE_STYLE_RICH, WINE_STYLE_BRIGHT, WINE_STYLE_SMOOTH, WINE_STYLE_BALANCED, WINE_STYLE_HOPPY, WINE_STYLE_LIGHT, WINE_STYLE_BOLD | |
| alcohol_type | string | Alcohol type refers to the type of Alcohol that is used in Hard Beverages or used to make cocktails in Alcohol Making Kits. | Vodka, Whiskey, Beer | |
| alcohol_aging_vessel | string | Aging Vessel refers to vessel in which the alcohol is aged. It impacts the alcohol's final taste and complexity. | Oak Barrel, Stainless Steel, Clay Pot | |
| alcohol_ibu | string | Applies to Beer only; stands for international bitterness units that measures a beers bitterness which is derived from hops in the brewing process | 45, 70, 30 | |
| alcohol_included_items | string | Included Items refers to additional items a product may come with or the items a set comes with. | USB cable, Remote Control, Cleaning Brush | |
| alcohol_tasting_notes | string | Tasting notes refers to the aromas and taste characteristics of the alcohol that include how it was aged (oak barrel), where it was grown, or, in wine specifically, when the grape was picked (younger vs older grape). | CARAMEL, CITRUS, PEAR, HOPPY, MALTY, OAK, SMOKE, SOUR, SPICED, TOAST, VANILLA, CHOCOLATE, HONEY, SWEET, WOOD, NUT, BERRY, APPLE, EARTH, DRY FRUIT, COFFEE, FLORAL, FRUITY | |
| alcohol_distillation | string | How the alcohol was distilled, such as something was triple distilled | Triple distilled, Pot distilled | |
| Beauty/Cosmetics Properties | benefits | string | Benefits refers to how the product can help the consumer. Often tied to concerns. | BENEFIT_HYDRATING, BENEFIT_PLUMPING, BENEFIT_LONG_WEARING, BENEFIT_VOLUMIZING, BENEFIT_CURLING, BENEFIT_WATERPROOF, BENEFIT_WATER_RESISTANT, BENEFIT_TRANSFER_RESISTANT, BENEFIT_TRANSFER_PROOF, BENEFIT_LENGTHENING, BENEFIT_BLENDING, BENEFIT_CONTOURING, BENEFIT_HIGHLIGHTING, BENEFIT_STRENGTHENING, BENEFIT_FAST_DRYING, BENEFIT_MEDICATED, BENEFIT_DISPOSABLE, BENEFIT_DERMATOLOGIST_TESTED, BENEFIT_SUN_PROTECTION, BENEFIT_SQUEAKS, BENEFIT_ADJUSTABLE, BENEFIT_REFLECTIVE, BENEFIT_PORTABLE, BENEFIT_WEATHER_RESISTANT |
| finish | string | Finish refers to how the makeup appears on the skin after application. | FINISH_RADIANT, FINISH_SHIMMER, FINISH_GLITTER, FINISH_METALLIC, FINISH_HIGH_SHINE, FINISH_NATURAL, FINISH_MATTE, FINISH_SATIN, FINISH_SHEER, FINISH_DEWY, FINISH_GLOSS | |
| coverage | string | Coverage refers to the concentration of pigment in the foundation. | COVERAGE_SHEER, COVERAGE_LIGHT, COVERAGE_MEDIUM, COVERAGE_FULL, COVERAGE_BUILDABLE | |
| skin_types | string | Skin Type refers to that describes how oily, dry, or sensitive a person's skin is. | SKIN_TYPE_OILY, SKIN_TYPE_SENSITIVE, SKIN_TYPE_NORMAL, SKIN_TYPE_COMBINATION, SKIN_TYPE_DRY, SKIN_TYPE_ALL, SKIN_TYPE_MATURE, SKIN_TYPE_ACNE_PRONE | |
| spf | string | SPF refers to the amount of SPF in a product. | SPF_4, SPF_8, SPF_15, SPF_30, SPF_45, SPF_60, SPF_90, SPF_110, SPF_ABOVE_30, SPF_BELOW_30, SPF_NO_SPF | |
| fragrance_family | string | Fragrance Family refers to the general family of fragrance the Fragrance Type or branded name of the Fragrance (Sub-brand) belongs to. | FRAGRANCE_FAMILY_NO_FRAGRANCE, FRAGRANCE_FAMILY_WARM_AND_SPICY, FRAGRANCE_FAMILY_FLORAL, FRAGRANCE_FAMILY_FRESH, FRAGRANCE_FAMILY_WOODY_AND_EARTHY, FRAGRANCE_FAMILY_SWEET, FRAGRANCE_FAMILY_FRUITY_AND_CITRUS | |
| fragrance_type | string | Fragrance Type refers to the fragrance or scent of the product. For the branded name of the Fragrance (Aqua di Gio, Be Happy, etc), use Sub-brand. | FRAGRANCE_TYPE_WARM_AND_SWEET_GOURMANDS, FRAGRANCE_TYPE_WARM_FLORALS, FRAGRANCE_TYPE_CLASSIC_FLORALS, FRAGRANCE_TYPE_COOL_SPICES, FRAGRANCE_TYPE_FRUITY_FLORALS, FRAGRANCE_TYPE_FRESH_AQUATICS, FRAGRANCE_TYPE_FRESH_CITRUS_AND_FRUITS, FRAGRANCE_TYPE_WARM_WOODS, FRAGRANCE_TYPE_WARM_AND_SHEER, FRAGRANCE_TYPE_FRESH_FLORALS, FRAGRANCE_TYPE_WOODY_SPICES, FRAGRANCE_TYPE_CITRUS_AND_WOODS, FRAGRANCE_TYPE_EARTHY_GREENS_AND_HERBS, FRAGRANCE_TYPE_FRESH_SOLAR, FRAGRANCE_TYPE_CLASSIC_WOODS, FRAGRANCE_TYPE_POWDERY_FLORALS | |
| formulation | string | Form refers to the item form or formulation of the product. | FORMULATION_SPRAY, FORMULATION_CREAM, FORMULATION_MATTE, FORMULATION_POWDER, FORMULATION_LIQUID, FORMULATION_ROLLERBALL, FORMULATION_TRAVEL_SPRAY, FORMULATION_OIL, FORMULATION_CANDLE, FORMULATION_SET, FORMULATION_DIFFUSER, FORMULATION_EAU_DE_PARFUM, FORMULATION_EAU_DE_TOILETTE, FORMULATION_STICK, FORMULATION_PENCIL, FORMULATION_GLOSS, FORMULATION_GEL, FORMULATION_BALM, FORMULATION_NON_AEROSOL, FORMULATION_AEROSOL, FORMULATION_STAIN, FORMULATION_MOUSSE, FORMULATION_POMADE, FORMULATION_WAX, FORMULATION_CAPSULES, FORMULATION_LOTION, FORMULATION_GUMMY, FORMULATION_TABLET, FORMULATION_SOFTGEL, FORMULATION_FOAM | |
| hair_type | string | Hair Type refers to the thickness of hair. | HAIR_TYPE_FINE_HAIR, HAIR_TYPE_MEDIUM_HAIR, HAIR_TYPE_THICK_HAIR, HAIR_TYPE_MULTI_CULTURAL, HAIR_TYPE_TEMPORARY | |
| hair_texture | string | Hair texture refers to the texture of hair. | HAIR_TEXTURE_WAVY_HAIR, HAIR_TEXTURE_CURLY_HAIR, HAIR_TEXTURE_STRAIGHT_HAIR, HAIR_TEXTURE_COILY_HAIR | |
| cosmetic_ingredients | string | Ingredients refers to what is used or added to make a product. | COSMETIC_INGREDIENT_PARABEN_FREE, COSMETIC_INGREDIENT_SULFATE_FREE, COSMETIC_INGREDIENT_CLEAN_AT_SEPHORA, COSMETIC_INGREDIENT_CRUELTY_FREE, COSMETIC_INGREDIENT_PEPTIDES, COSMETIC_INGREDIENT_FRAGRANCE_FREE, COSMETIC_INGREDIENT_VEGAN_INGREDIENTS, COSMETIC_INGREDIENT_OIL_FREE, COSMETIC_INGREDIENT_HYALURONIC_ACID, COSMETIC_INGREDIENT_SILICONE_FREE, COSMETIC_INGREDIENT_ALCOHOL_FREE, COSMETIC_INGREDIENT_VITAMIN_C, COSMETIC_INGREDIENT_MINERAL, COSMETIC_INGREDIENT_ANTIOXIDANTS, COSMETIC_INGREDIENT_NIACINAMIDE, COSMETIC_INGREDIENT_CLEAN_PLANET_POSITIVE, COSMETIC_INGREDIENT_AHA_GLYCOLIC_ACID, COSMETIC_INGREDIENT_SQUALANE, COSMETIC_INGREDIENT_NATURALLY_DERIVED, COSMETIC_INGREDIENT_ZINC, COSMETIC_INGREDIENT_HYDROQUINONE, , COSMETIC_INGREDIENT_BENZOYL_PEROXIDE, COSMETIC_INGREDIENT_SALICYLIC_ACID, COSMETIC_INGREDIENT_SULFUR, COSMETIC_INGREDIENT_RETINOID, COSMETIC_INGREDIENT_ADAPTOGENS, COSMETIC_INGREDIENT_ORGANIC_INGREDIENTS, COSMETIC_INGREDIENT_COLLAGEN, COSMETIC_INGREDIENT_NON_COMEDOGENIC, COSMETIC_INGREDIENT_PROTEIN, COSMETIC_INGREDIENT_BIOTIN, COSMETIC_INGREDIENT_KERATIN, COSMETIC_INGREDIENT_SILK, COSMETIC_INGREDIENT_VITAMIN_E, COSMETIC_INGREDIENT_S, HEA_BUTTER, COSMETIC_INGREDIENT_ALOE, COSMETIC_INGREDIENT_AMINO_ACID, COSMETIC_INGREDIENT_CHAMOMILE, COSMETIC_INGREDIENT_CALCIUM, COSMETIC_INGREDIENT_HONEY, CO, COSMETIC_INGREDIENT_GREEN_TEA, COSMETIC_INGREDIENT_GINKGO_BILOBA, COSMETIC_INGREDIENT_JOJOBA_OIL, COSMETIC_INGREDIENT_OLIVE_OIL, COSMETIC_INGREDIENT_VITAMIN_B, COSMETIC_INGREDIENT_VITAMIN_A, COSMETIC_INGREDIENT_RICE_POWDER, COSMETIC_INGREDIENT_CASTOR_OIL, COSMETIC_INGREDIENT_GINSENG, COSMETIC_INGREDIENT_ROSEMARY, COSMETIC_INGREDIENT_COCONUT, COSMETIC_INGREDIENT_TEA_TREE_OIL, COSMETIC_INGREDIENT_KAOLIN_CLAY, COSMETIC_INGREDIENT_WITCH_HAZEL, COSMETIC_INGREDIENT_LAVENDER, COSMETIC_INGREDIENT_SUGAR, COSMETIC_INGREDIENT_ARGAN_OIL, COSMETIC_INGREDIENT_HYPOALLERGENIC, COSMETIC_INGREDIENT_ALUMINUM_FREE, COSMETIC_INGREDIENT_PHTHALATE_FREE, COSMETIC_INGREDIENT_FORMALDEHYDE_FREE, COSMETIC_INGREDIENT_GLUTEN_FREE | |
| concerns | string | Concerns refers to the consumers desire to help alleviate. | CONCERN_DRYNESS, CONCERN_PORES, CONCERN_OILINESS, CONCERN_REDNESS, CONCERN_ACNE_BLEMISHES, CONCERN_DULLNESS, CONCERN_UNEVEN_TEXTURE, CONCERN_UNEVEN_SKIN_TONE, CONCERN_LOSS_OF_FIRMNESS_ELASTICITY, CONCERN_FINE_LINES_WRINKLES, CONCERN_MOOD_SUPPORT, CONCERN_IMMUNITY, CONCERN_JOINT_HEALTH, CONCERN_STRESS_MANAGEMENT, CONCERN_SLEEP, CONCERN_EYE_HEALTH, CONCERN_FEVER, CONCERN_GAS, CONCERN_DIARRHEA, CONCERN_DARK_SPOTS, CONCERN_ANTI_AGING, CONCERN_COLOR_PROTECTION, CONCERN_CURL_ENHANCING, CONCERN_DAMAGED, CONCERN_FRIZZ_FREE, CONCERN_THINNING, CONCERN_DRY_SCALP, CONCERN_SHINE, CONCERN_HEAT_PROTECTION, CONCERN_STRAIGHTENING, CONCERN_CELLULITE, CONCERN_SCALP_BUILD_UP, CONCERN_STYLE_AND_HOLD, CONCERN_DARK_CIRCLES, CONCERN_CHIP_RESISTANT, CONCERN_GRAY_COVERAGE, CONCERN_COLOR_CORRECTING, CONCERN_SKIN_AND_COAT_HEALTH, CONCERN_ORAL_HEALTH, CONCERN_DIGESTIVE_HEALTH, CONCERN_BONE_HEALTH, CONCERN_WEIGHT_MANAGEMENT, CONCERN_PEST_REPELLENT_PREVENTION, CONCERN_ITCH_RELIEF, CONCERN_PEST_ELIMINATION, CONCERN_OVERALL_HEALTH, CONCERN_HAIRBALL_CONTROL, CONCERN_BRAIN_HEALTH, CONCERN_EAR_HEALTH, CONCERN_URINARY_HEALTH, CONCERN_HEART_HEALTH, CONCERN_BAD_BREATH, CONCERN_ENERGY, CONCERN_CALMING, CONCERN_ALLERGY, CONCERN_PAIN_RELIEF, CONCERN_EAR_NOSE_THROAT_HEALTH, CONCERN_HEADACHE, CONCERN_MOTION_SICKNESS, CONCERN_HIGH_BLOOD_PRESSURE, CONCERN_MUSCLE_ACHE, CONCERN_NASAL_CONGESTION, CONCERN_NAUSEA, CONCERN_SINUS, CONCERN_SNEEZING, CONCERN_SORE_THROAT, CONCERN_STYE, CONCERN_DIABETES_SUPPORT, CONCERN_BRAIN_MEMORY_SUPPORT, CONCERN_ECZEMA, CONCERN_INGROWN_HAIRS, CONCERN_ITCHY_SKIN, CONCERN_KERATOSIS_PILARIS, CONCERN_PSORIASIS, CONCERN_ARTHRITIS, CONCERN_PREGNANCY_FERTILITY_PRENATAL_CARE, CONCERN_SCARS, CONCERN_FOOT_HEALTH, CONCERN_QUIT_SMOKING, CONCERN_BRUISES_BURNS, CONCERN_FEMININE_HEALTH, CONCERN_ODOR_CONTROL, CONCERN_FIRST_AID | |
| gender | string | Refers to the gender the product is marketed to. | GENDER_MEN, GENDER_WOMEN, GENDER_UNISEX | |
| scent | string | Describes the fragrance or aroma of a beauty or cosmetic product, such as "Lavender, " "Citrus, " or "Unscented." | Lavender, Unscented, Citrus | |
| cosmetics_brush_type | string | Brush type refers to the specific kind of brush. Applies to both hair and makeup brushes. | BRUSH_TYPE_CREASE_BRUSH, BRUSH_TYPE_CONCEALER_BRUSH, BRUSH_TYPE_BLUSH_BRUSH, BRUSH_TYPE_POWDER_BRUSH, BRUSH_TYPE_SHADOW_BRUSH, BRUSH_TYPE_LINER_BRUSH, BRUSH_TYPE_CONTOUR_BRUSH, BRUSH_TYPE_HIGHLIGHTER_BRUSH, BRUSH_TYPE_BROW_BRUSH, BRUSH_TYPE_BRONZER_BRUSH, BRUSH_TYPE_WELLNESS_TOOLS_AND_DEVICES, BRUSH_TYPE_FOUNDATION_BRUSH | |
| cosmetics_age_range | string | Age Range refers to the range of ages that is appropriate to the product. | 3-5 years, 18+, All ages | |
| formulation | string | Form refers to the item form or formulation of the product. | FORMULATION_SPRAY, FORMULATION_CREAM, FORMULATION_MATTE, FORMULATION_POWDER, FORMULATION_LIQUID, FORMULATION_ROLLERBALL, FORMULATION_TRAVEL_SPRAY, FORMULATION_OIL, FORMULATION_CANDLE, FORMULATION_SET, FORMULATION_DIFFUSER, FORMULATION_EAU_DE_PARFUM, FORMULATION_EAU_DE_TOILETTE, FORMULATION_STICK, FORMULATION_PENCIL, FORMULATION_GLOSS, FORMULATION_GEL, FORMULATION_BALM, FORMULATION_NON_AEROSOL, FORMULATION_AEROSOL, FORMULATION_STAIN, FORMULATION_MOUSSE, FORMULATION_POMADE, FORMULATION_WAX, FORMULATION_CAPSULES, FORMULATION_LOTION, FORMULATION_GUMMY, FORMULATION_TABLET, FORMULATION_SOFTGEL, FORMULATION_FOAM | |
| cosmetic_hair_length | string | Hair Length refers to the length of hair. | Short, Medium, Long | |
| cosmetics_false_hair_and_wig_type | string | Eyelash Type refers to what kind of eyelash the product is. | False Hair & Wig Type refers to what kind of false hair or wig the product is. | |
| cosmetics_color_permanence | string | Color Permanence refers to how long applied hair color lasts. | Semi-permanent, Permanent, Temporary | |
| cosmetics_eyelash_type | string | Eyelash Type refers to what kind of eyelash the product is. | Mink, Synthetic, Magnetic | |
| cosmetics_eyelash_style | string | Eyelash Style refers to the style of eyelash the product is. | Natural, Dramatic, Wispy | |
| cosmetics_application_method | string | Application Method refers to how the product is applied. | Apply with brush, Roll-on, Spray | |
| cosmetics_polish_type | string | Polish Type refers to the polish that is applied to the nail | Gel, Matte, Glossy | |
| cosmetics_nail_type | string | Nail Type refers to the type of fake nail. | Acrylic, Press-on, Gel | |
| cosmetics_nail_length | string | Nail Length refers to how long the nail is. | Short, Medium, Long | |
| cosmetics_shade_range | string | Shade Range refers to the broader range that encompasses brand color names for skin colored makeups. | Light Beige, Deep Chocolate, Tan | |
| cosmetics_body_area | string | Body area refers to the part or area of the body the product is intended for. | Face, Hands, Legs | |
| cosmetics_bristle_material | string | Bristle Material refers specifically to the material the bristles of a brush is made from. Applies to both hair and makeup brushes. | Synthetic, Boar Hair, Nylon | |
| cosmetics_comb_type | string | Comb Type refers to the type of comb. | Wide-Tooth, Fine-Tooth, Rat-tail | |
| cosmetics_curler_and_roller_type | string | Curler & Roller Type refers to the type of curler or roller. | Heated Rollers, Foam Rollers, Ceramic Curlers | |
| cosmetics_mounting_options | string | Mounting Options refers to how a mirror is mounted. | Wall-mounted, Tabletop, Freestanding | |
| cosmetics_hold | string | Hold refers to the strength/longevity of a products ability to hold a style. | Light hold, Medium hold, Strong hold | |
| cosmetics_barrel_size | string | Barrel Size refers to the diameter of the curling barrel. | 1 inch, 1.5 inches, 2 inches | |
| cosmetics_wattage | string | Wattage refers to the electrical power measurement of a product | 1200W, 1800W, 2400W | |
| cosmetics_included_items | string | Lists any additional items or accessories included with the beauty or cosmetic product. | Travel case, Charger, Instruction manual | |
| cosmetics_care_maintenance | string | Care & Maintenance refers to the instructions on how to care and maintain a product. | Hand wash, Machine washable, Wipe with a damp cloth | |
| cosmetics_reusability | string | Reusability refers to if the product is single use or can be reused. | Single-use, Reusable | |
| cosmetics_undertone | string | Undertone refers to the hue or tone of the skin to help match makeup products. | Warm, Cool, Neutral | |
| cosmetics_closure_type | string | Closure Type refers to the mechanism in which a bag or box is closed. | Zipper, Velcro, Magnetic snap | |
| cosmetics_handle_material | string | Handle Material refers specifically to the material the handle of a brush is made from. | Wood, Plastic, Metal | |
| cosmetics_frame_material | string | Frame Material refers to the material that makes up the frame of a mirror. | Aluminum, Wood, Plastic | |
| cosmetics_power_source | string | Power source is how the product receives power. | Battery, USB, Solar-powered | |
| Food & Drinks Properties | drinks_pulp_level | string | Pulp level refers to the amount of pulp or fibrous portions of fruit in the juice product. | No pulp, Some pulp, High pulp |
| drinks_protein_type | string | Protein Type refers to the kind of protein added to drinks. | Whey, Soy, Collagen | |
| drinks_tea_type | string | Tea Type refers to applies to the kind of tea the product is. | Green Tea, Black Tea, Herbal Tea | |
| drinks_coffee_bean_type | string | Coffee Bean Type refers to the type of coffee bean. | Arabica, Robusta, Liberica | |
| drinks_roast_level | string | Roast Level refers to how long and thoroughly coffee beans have been roasted. | Medium roast, Dark roast, Light roast | |
| drinks_water_source | string | Water Source refers to where the water is sourced from. | Spring Water, Glacier Water, Artesian Well | |
| drinks_caffeine_content | string | Caffeine Content refers to the amount of caffeine in a product. | 50mg per serving, Decaffeinated, 120mg per can | |
| drinks_form | string | Form refers to the item form or formulation of the product. | Liquid, Powder | |
| dietary_tags | string | Dietary values for an item include information about dietary restrictions, fat, sugar, salt content, and whether it's kosher or meets other dietary needs. | KOSHER, GLUTEN_FREE, DAIRY_FREE, ORGANIC, VEGAN, LACTOSE_FREE, SOY_FREE, NUT_FREE, CONTAINS_PEANUTS, VEGETARIAN, KETO, GRASS_FED, HALAL, LOCALLY_RAISED, DRY_AGED, WET_AGED, FREE_RANGE, NATURAL, HORMONE_FREE, ANTIBIOTIC_FREE, HUMANELY_RAISED, WILD_CAUGHT, PASTURE_RAISED, CAFE_FREE, AIR_CHILLED, HERITAGE_BREED, SLOW_GROWTH, NITRATE_FREE, FARM_RAISED, ANGUS_100, ANGUS_CERTIFIED, FAT_FREE, REDUCED_FAT, WITH_58_LESS_FAT_AND_57_LESS_SODIUM, UP_TO_10_SALT, LOW_CHOLESTEROL, REDUCED_SODIUM, LITE, PLANT_BASED, NO_SUGAR, LOWER_SODIUM, MEAT_FREE, NATURALLY_FLAVORED, LOW_CALORIES, HIGH_PROTEIN, MSC_CERTIFIED, WITH_GRAIN, GRAIN_FREE, NON_GMO, RAW, NON_ALCOHOLIC, ALCOHOLIC, SULFITE_FREE | |
| fat_content | string | The fat content of an item refers to the amount of fat present in the product, typically measured as a percentage of the total weight.- | LEAN, EXTRA_LEAN, LEAN_70, LEAN_75, LEAN_80, LEAN_85, LEAN_90, LEAN_70_FAT_30, LEAN_71_FAT_29, LEAN_72_FAT_28, LEAN_73_FAT_27, LEAN_74_FAT_26, LEAN_75_FAT_25, LEAN_76_FAT_24, LEAN_77_FAT_23, LEAN_78_FAT_22, LEAN_79_FAT_21, LEAN_80_FAT_20, LEAN_81_FAT_19, LEAN_82_FAT_18, LEAN_83_FAT_17, LEAN_84_FAT_16, LEAN_85_FAT_15, LEAN_86_FAT_14, LEAN_87_FAT_13, LEAN_88_FAT_12, LEAN_89_FAT_11, LEAN_90_FAT_10, LEAN_91_FAT_9, LEAN_92_FAT_8, LEAN_93_FAT_7, LEAN_94_FAT_6, LEAN_95_FAT_5, LEAN_96_FAT_4, LEAN_97_FAT_3, LEAN_98_FAT_2, LEAN_99_FAT_1, LEAN_100_FAT_0 | |
| service_counter | bool | Whether or not the item is sold behind a meat service/deli counter in a grocery store. | TRUE, FALSE | |
| shape_and_cut | string | The shape or way the food is cut, like "Diced" or "Whole." | Diced, Sliced, Whole | |
| item_count | string | Item count refers to the specific number of items within a pack or across multi-packs, bag, box, approx count of shellfishes per pound/pack, etc. | 24 pieces, 10 bags, 6 cans | |
| non_numerical_size | string | Non-numerical size refers to the physical size of the item itself, such as whether it's jumbo or mini. It's more about the dimensions or bulk of the item. | Mini, Jumbo, Medium | |
| certification_and_production_details | string | The certification/production details indicate any special methods or certifications describing how something was raised, harvested, produced, or manufactured. | Free-Range, USDA Organic, Certified Humane | |
| side_component | string | The additional item or ingredient served alongside the main food product, such as "with fries" or "with bbq sauce." | with fries, with ketchup, with BBQ sauce | |
| is_combo_item | bool | Indicates whether the item is part of a combo meal or package deal that includes multiple components. | Yes, No | |
| food_source | string | The source of an item refers to where it originally comes from, such as its location or geographic origin (state/country), unless the locational origin specifies the species. (e.g. “Alaskan Salmon” is a species so “Alaskan” should not be considered as a source. “Hokkaido” does not specify a species of fish so it can be considered Source”) | California, Peru, Texas | |
| species | string | The species of an item refers to the type of animal it comes from. If the species modifier is ambiguous (“Pink” can refer to “Pink Salmon”, “Pink Shrimp”, or simply just the color) the restricted value should contain the type of animal. | Pink Salmon, Alaskan Cod, Chicken | |
| General Information | sub_brand | string | Sub brand" refers to a brand that is part of or associated with the main brand. It represents a specific line or category of products produced by the main brand | Applegate Organic, Starbucks' Teavana |
| chocolate_type | string | Chocolate Type refers to the kind of chocolate used in the product. | Dark Chocolate, Milk Chocolate, White Chocolate | |
| item_limit | number | The maximum number of items a customer can buy at one time. | 5 per customer, 10 max | |
| manufacturer | string | Used for Ads; Manufacturer of the item and owner of the item's brand | Procter & Gamble, Nestle, Samsung | |
| is_private_label | bool | Mechanism for flagging if an item's brand is a merchant private label brand | TRUE, FALSE | |
| occasion | string | The event or situation the item is meant for, like "Wedding" or "Birthday." | SUPERBOWL, VALENTINES_DAY, MARCH_MADNESS, EASTER, MOTHERS_DAY , NBA_Finals, SUMMER_OF_DASHPASS, FATHERS_DAY, FOURTH_OF_JULY, SUMMER_OLYMPICS, BACK_TO_SCHOOL, FALL_FOOTBALL, HALLOWEEN, THANKSGIVING, HANUKKAH, CHRISTMAS, NEW_YEARS, ST_PATRICKS_DAY, CINCO_DE_MAYO, MEMORIAL_DAY, LABOR_DAY, BLACK_FRIDAY | |
| exclusive | string | Refers to an item that is available only at a specific store or through a specific seller. | Walmart Exclusive, Amazon Exclusive | |
| texture | string | Texture refers to the mouth feel of the product. | Creamy, Crunchy, Smooth | |
| container_type | string | Container type refers to the container the product is in. | Bottle, Can, Box, Keg | |
| shopping_preference | string | Preferred method for purchasing products or class of items (e.g., local, luxury, limited edition, etc.) | SHOPPING_PREFERENCE_BLACK_OWNED, SHOPPING_PREFERENCE_LOCAL, SHOPPING_PREFERENCE_AFFORDABLE, SHOPPING_PREFERENCE_LUXURY, SHOPPING_PREFERENCE_PREMIUM, SHOPPING_PREFERENCE_LIMITED_EDITION, SHOPPING_PREFERENCE_ONLY_AT_SEPHORA, SHOPPING_PREFERENCE_PLANET_AWARE, SHOPPING_PREFERENCE_BEST_OF_ALLURE, SHOPPING_PREFERENCE_ONLY_AT_ULTA, SHOPPING_PREFERENCE_CONTAINS_RECYCLED_CONTENT, SHOPPING_PREFERENCE_RECYCLABLE, SHOPPING_PREFERENCE_RENEWABLE_RESOURCE, SHOPPING_PREFERENCE_BIO_BASED, SHOPPING_PREFERENCE_PLANT_BASED, SHOPPING_PREFERENCE_COMPOSTABLE, SHOPPING_PREFERENCE_RENEWABLE_MATERIAL, SHOPPING_PREFERENCE_BIODEGRADABLE | |
| Health Properties | limited_edition | string | Edition refers to special limited edition runs, events or holidays. | Limited Edition, Holiday Edition, Anniversary Edition |
| certification_tag | string | Describes any certifications or labels the health product carries, such as "Organic, " "Non-GMO, " or "FDA Approved." | Organic, Non-GMO, Fair Trade Certified | |
| Package Information | package_type | string | Package Type indicates how the item is packaged together (multi-pack) or is a value deal (value pack) | Value Pack, Mega Pack, Family Pack, Twin Pack, Pack |
| Variant | product_group | string | Merchant's unique product id for items that have multiple variations. | A tshirt that comes in multiple colors (x4) and sizes (x3) will have 1 product_group: 5571649 and 7 sku-ids. A foundation that comes in multiple shades (x40) will have 1 product_group: 5321374 and 40 sku-ids |
| color_family | string | Color Family refers to the broader, basic colors a Color Name belongs to. | Black, Multi, Pink, Nude, Coral, White, Berry, Brown, Silver, Red, Grey, Gold, Green, Blue, Purple, Clear, Orange, Yellow | |
| color_name | string | Color Name refers to the branded name of the product. | Whirl, Vanilla, 001, NC2 | |
| hex_code | string | A 6-digit code that represents the exact color of the item, which can be used to support swatches. | 603638, E96187, 920046, BF1790 | |
| flavor | string | Flavor refers to the taste of the beverage. Can be naturally or artificially flavored. | Vanilla, Lemon, Chocolate, Strawberry | |
| swatch_image_url | string | Swatch data should be passed in the format of a swatch image URL or a 6-digit hex code. | 603638, E96187, 920046, BF1790 | |
| Weighted Item Properties | preparation_method | string | Preparation Method refers to how the snack was made/prepared. | Roasted, Grilled, Boiled |