--- title: "Creating Walmart Items via Unified" img: https://s3.us-east-2.amazonaws.com/unified-article-images/creating_walmart_items_via_unified-icon.png date: 2025-07-31T00:00:00.000Z tag: Guides description: "Unified allows you to create structured product listings on Walmart Marketplace via our Unified data model `commerceitem`. This guide explains the critical..." url: "https://docs.unified.to/guides/creating_walmart_items_via_unified" --- # Creating Walmart Items via Unified ------ _July 31, 2025_ Unified allows you to create structured product listings on **Walmart Marketplace** via our Unified data model `commerce_item`. This guide explains the **critical fields** you must understand and provide correctly: --- ### 🧩 Key Concepts | Field | Description | | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `type` | This specifies the **Walmart subcategory** your item belongs to. It determines what metadata is required. Must be one of the supported 76 categories (see below). | | `global_code` | This is your product's **GTIN** (Global Trade Item Number), a required identifier for Walmart. It must be a **valid 12–14 digit string**. | | `metadata` | A dynamic array of key-value attributes that depends on the selected `type`. This is how you provide structured product details like color, material, warranty, etc. | --- ### 🧠 How Metadata Works Each `type` (subcategory) has a corresponding schema of fields allowed by Walmart. For example: - `animal_accessories` allows fields like `animalType`, `petSize`, `isFoldable`, `colorCategory`, etc. - `computers` allows fields like `processorType`, `screenSize`, `ramMemory`, `operatingSystem`, etc. **List the metadata fields from Unified** using this API ```typescript GET /metadata_metadata?type=commerce_item [ { "id": "shortDescription", "name": "shortDescription", "slug": "shortDescription", "format": "TEXT", "original_format": "string", "object_type": "commerce_item" }, { "id": "minimumRecommendedAge", "name": "minimumRecommendedAge", "slug": "minimumRecommendedAge", "format": "MEASUREMENT", "original_format": "{\"measure\":\"number\",\"unit\":[\"months\",\"years\"]}", "object_type": "commerce_item" }, { "id": "smallPartsWarnings", "name": "Small Parts Warning Code", "slug": "smallPartsWarnings", "format": "MULTIPLE_SELECT", "original_format": "string[]", "options": [ "0 - No warning applicable", "5 - Choking hazard is a marble", "4 - Choking hazard balloon", "6 - Choking hazard contains a marble", "2 - Choking hazard contains small ball", "3 - Choking hazard contains small parts", "1 - Choking hazard is a small ball" ], "object_type": "commerce_item" }, ] ``` You can filter these results by inspecting the supported pagination options. --- ### Supported `type` Values for Walmart Items (commerce_item) - `Skateboard Risers` - `Baby Play Yards` - `Power Hedge Trimmers` - `Eyeglass Cases` - `Microphone Splitters` - `Electric Buffet Servers` - `Radio Control Vehicle Servos` - `Sticky Notes` - `Matcha Tea Bowls & Whisks` - `Doughs` - `Taffy Candy` - `Hair Dryers` - `Base Layers` - `Emergency Lighting` - `Bidet Toilet Seats` - `Purse Making Supplies` - `Grill Grid Lifters` - `Hunting Scents` - `Automotive Headlight Restorer` - `Ear Thermometer Replacement Lens Filters` - `Glassware & Drinkware` - `Precious Metals` - `Lab Chromatography Paper` - `Plant Terrariums` - `Microphone Cables` - `Glucose Supplements` - `Snow Skis` - `Perineal Cleansers` - `Soda Maker Kits` - `Camera Accessory Bundles` - `Tetherball Equipment` - `Paint Reducers & Retarders` - `Pork Rinds` - `Portable Basketball Systems` - `Plate Joiners` - `Other Weight Loss Supplies` - `Powder Candy` - `Outdoor Kitchen Serving & Storage Carts` - `Unitards & Leotards` - `Lab Sample Bags` - `Fishing Rod & Reel Combos` - `Adhesive Tapes` - `Track & Field Markers` - `Fruit & Vegetable Corers` - `Automotive Fuel Tank Caps` - `Drawing Boards` - `Hand Dryers` - `Pregnancy Tests` - `Cat Litter Mats` - `Facial Wipes` - `Exercise Weights` - `Sewing Pins` - `Other Makeup Brushes & Tools` - `Other Shaving Supplies` - `Sugar Packet Holders` - `Honey Dippers` - `Artificial Topiaries` - `Cupcake Making Kits` - `Mobility Walker Bags, Baskets & Carriers` - `Faucet Water Filters` - `Urinary Tract Infection Test Strips` - `Baptism Gowns & Outfits` - `Function Generators` - `FM Transmitters` - `Home Brewing Refractometers` - `Saddle Bags` - `Track & Field Competitor Numbers` - `Fuel Distributors` - `Nicotine Patches` - `Griddles & Grill Pans` - `Planter & Stand Sets` - `Other Pet Health Supplies` - `Scooter Decks` - `Knitting & Crochet Stitch Counters` - `Camera Tool Kits` - `Eyelash Combs` - `Blouses & Tops` - `Knitting & Crochet Stitch Markers` - `Hand Tool Punches` - `Climbing Rappel Devices` - `Kitchen Towels` - `Homogenizer Accessories` - `Attendance Time Cards` - `Digital Camera Parts` - `Planners & Appointment Book Refills` - `Herbal Supplements` - `Hand-Sewing Needles` - `Weight Bars` - `Photography Fixers` - `Massage Table Carrying Cases` - `Grill Covers` - `Other Skating Supplies` - `Maple Syrups` - `Pizza Stones & Pans` - `Manual Letter Openers` - `Water Guns` - `Manual Can Openers` - `Electronic Touchpads` - `String Trimmer Replacement Parts` - `Baby Bodysuits & One-Pieces` - `Walking Cane & Crutch Tips` - `Cutting Mats` - `Throwing Knives` - `Skins for Tablets` - `Serving Utensils & Sets` - `Photographic Art` - `Soap Making Kits` - `Athletic Shirts & Tops` - `Ticket Rolls` - `Fireplace Bellows` - `Travel Plug Adapters` - `Vacuum Sealers` - `Small Animal Habitat Decor` - `Vacuum Tubes` - `Stroller Connectors` - `Ceiling Fans` - `Other Dancing Supplies` - `Model Train Locomotives` - `Electronic Cigarette Starter Kits` - `Bicycle Baskets` - `Golf Visors` - `Bicycle Storage Hooks` - `Handheld Video Games` - `Cocktail Mixers` - `Follow-Focus Levers` - `Embossing Tools` - `Incentive Charts` - `Pressure Gauges` - `Art Paints & Pigment Powders` - `Replacement Water Filters` - `Moisture Meters` - `Other Pet Grooming Supplies` - `Shopping Cart & High Chair Covers` - `Nursing Pillows` - `Disposable Cutlery Sets` - `Heat Guns` - `Construction Flashing` - `Automotive Aerodynamics Kits` - `Fire Retardants` - `Gun Snakes` - `Snow Removal Rakes & Hand Pushers` - `Costume Wigs` - `Outdoor Decorative Stones` - `Lip Stains` - `Workwear Uniform Badges` - `Gut Health Tests` - `Carbon Monoxide Alarms` - `Cable Covers` - `Lathe Cylindrical Rollers` - `Hamburger Patty Makers` - `Printing Press Accessories` - `Automotive Light Covers & Guards` - `Overbed Tables` - `Artwork Cases & Portfolios` - `Disposable Storage Bags` - `Football Helmets` - `Automatic Transmission Filters` - `Live Trees` - `Umpire Leg Guards` - `Line Conditioners` - `Cup & Saucer Sets` - `Rain Barrels` - `S` - `,` - `s Tapes` - `Indoor Fireplaces` - `Headphone Cases` - `Battery Testers` - `Floor Hockey Carts` - `T-Shirts` - `Dunun Drums` - `Speed Reducers` - `Percussion Mallets` - `Pallet Covers` - `Telescope Cases` - `Automotive Grilles` - `Fencing Sport Epee Parts` - `Emergency Food Kits` - `Sports Corner Flags` - `Bird Nests & Nesting Material` - `Boxing Rings` - `Paper Sorters` - `Lollipop & Treat Sticks` - `Cabin Air Filters` - `Pool Covers` - `Video Game Dance Pads` - `Football Sleds & Chutes` - `Clay & Dough Extruders & Presses` - `Baseball Gloves & Mitts` - `Yeasts & Leaveners` - `Skins for Aerial Drones` - `Replacement Faucet Water Filters` - `Other Electronic Components & Accessories` - `Lab Coats` - `Laser Detectors` - `Baseball Sliding Shorts` - `Hunting Game Finders` - `Rain & Snow Gauges` - `Shapewear Bodysuits` - `Toiletry Kits & Bags` - `Photo Enlarger Heads` - `Athletic Outfit Sets` - `Combustion Analyzers` - `Personal Organizer Refills & Accessories` - `Harmonic Exciters` - `Billiard Table Felt` - `Video Game Console Parts` - `Ham Radio Transceivers` - `Baby Juices` - `Hot Dog Machines` - `Pipe Inspection Cameras` - `Misting Systems` - `Sleeping Bag Liners` - `Kids Gardening Tools` - `Camera Film Winders` - `Other Billiard Supplies` - `Ergonomic Backrests` - `Balloon Pumps` - `Lump Charcoals` - `Pilates Barrels` - `Surfing Leashes` - `Dart Shafts` - `Makeup Blotting Paper` - `Eye Masks` - `Welding Helmets` - `Electronic Coils` - `Energy Drinks` - `Push-Up Stands` - `Photography Stop Baths` - `Handbag Hook Hangers` - `Network Security Devices` - `Stitch Holders` - `Bicycle Pegs` - `Outdoor Daybeds` - `Party Favors` - `Canning Kits` - `Molding & Casting Materials & Kits` - `Musical Instrument Bodies` - `Other Games` - `Electrolyte Solutions` - `Fruit & Wine Crushers & Destemmers` - `Power Inverters` - `Jewelry Jump Rings & Split Rings` - `Table Tennis Paddles` - `SIM Card Backup Devices` - `Tie Pins` - `Billiard Tables` - `Archery Broadheads` - `Vehicle Windshields` - `Jock Straps` - `Pet Live Animals` - `DC-to-DC Converters` - `Transport Drums` - `Vinyl Figures` - `Entertainment Centers` - `Fireplace Tools` - `Serving Forks` - `Nut Splitters` - `Blasters & Foam Play` - `Garden Border Edging` - `Gun Holsters & Holders` - `Spice Racks & Organizers` - `Stamps & Stamp Sets` - `Udu Drums` - `Reception Chairs & Seating` - `Pepper & Peppercorns` - `Golf Drivers` - `CC Cream` - `Yoga Socks` - `Vacuum Cleaner Attachments` - `Planter Liners` - `Pie & Pastry Fillings` - `Bed Skirts` - `Dart Carrying Cases & Wallets` - `Pizza Ovens` - `Crepe Spreaders` - `Hex Tools` - `Stretch Film & Shrink Wrap` - `Massage Headrests` - `Electronics Carrying Cases` - `Dust Collectors` - `Decorative Stones` - `Yoga Straps` - `Espresso Machines` - `Lab Face Masks & Shields` - `Guitar Effects Pedals` - `Hockey Hip Pads` - `Pressure Cookers & Canners` - `Diabetic Foot Care` - `Nail Top Coat` - `Wax Molding Materials` - `Dock Guards` - `Decoupage Tools & Sets` - `Rugby Balls` - `Bra Back Adapters` - `Other Backyard Wildlife Supplies` - `Food Peelers` - `Modular Synthesizers` - `Mirror Balls` - `Cricket Wickets` - `Snatch Rigging Blocks` - `Rowing Shells` - `Staple Gun Staples` - `Golf Rangefinders` - `Waterbed Liners` - `Beer Glasses` - `KVM Switches` - `Panel Carriers` - `Sanding Frames` - `First Aid Tape` - `Hand Pruners & Loppers` - `Reusable Training Pants` - `Outdoor Spas` - `Air Hockey Pucks` - `Cat Trees` - `Surgical Gowns` - `Baseball Protective Screens` - `Artificial Plants` - `Basting Brushes` - `Archery Arrows` - `Calibration Weights` - `Laptop Computers` - `Chalkboard Chalk` - `Nasal Aspirators` - `Instant Coffee` - `Vanity Tables & Table & Bench Sets` - `Printer Drums` - `Automotive Body Paint` - `Paraffin Treatment Hand & Foot Mitts` - `Stovetop Espresso Pots` - `Robotic Lawn Mowers` - `Phone Grips` - `Hammock Chairs` - `Home Brewing Kegs & Keg Supplies` - `Dishwasher Rack Adjusters` - `Sculpting Tools & Kits` - `Mattocks & Pickaxes` - `Watch & Clock Hands` - `Umpire Bags` - `Other Lighting Accessories` - `Lab Shaker Accessories` - `Print Servers` - `Home Brewing Beer Bottle Trees` - `Football Hand Warmers` - `Spectrum Analyzers` - `Hair Perms & Texturizers` - `Lab Glassware Washers` - `Trailer Weight Distributing Systems` - `Digital Cameras` - `Drum & Pail Mixers` - `Porch Swings` - `Gun Choke Tubes` - `Pet Milk Replacers` - `Fabric Paints` - `Other Kiteboarding Accessories` - `Paper Cups` - `Bottle Pourers` - `Golf Divot Tools` - `Aquarium Cleaning Tools` - `Fishing Vest & Packs` - `Die-Cut Cartridges` - `Kiteboard Control Bars` - `Welding Tips` - `Food Tongs` - `Corn & Callus Remover Cushions` - `Cocktail Shakers` - `Inspection Mirrors` - `Fruit Snacks` - `Kayak Storage Racks` - `Cycling Vests` - `Field Hockey Goggles` - `Breathalyzer Alcohol Monitors` - `Dry Erase Markers` - `Racquet Sport Stringing Machines` - `Gun Swivels` - `Power Tool Chargers` - `Home Brewing Sanitization Kits` - `Ice Cream, Sorbet & Frozen Yogurt` - `Underwater Cameras` - `Hair Color Stain Shields` - `Roof Gutter Accessories` - `Bicycle Brake Rotors` - `Repinique Drums` - `Camera Film Backs & Holders` - `Automotive Cigarette Lighters & Plugs` - `Meal Kits` - `Lathe Cole Jaws` - `PBX Phone Systems` - `Face Serums` - `Exercise Treadmills` - `Lawn Sweepers` - `Sunglasses Replacement Lenses` - `Pipe Fitting Reducers` - `Microphone Pop Filters` - `MiniDisc Players` - `Audio/Video Cables` - `Hand Sanitizers` - `Nail Pullers` - `Traditional Salwar Kameez` - `Other Air Tool Accessories` - `Cymbal Pads` - `Automotive Winch Mounting Systems` - `Laptop Bags` - `Contour Makeup Set` - `Puzzle Cubes` - `Plant Covers` - `Empty Paint Cans` - `Tableware Knives` - `Storage Sheds` - `Window & Door Frames` - `Paper Plates` - `Calculator Accessories` - `Shaving Sets` - `Microphone Preamplifiers` - `Baby Feeding Chairs` - `Rain Ponchos` - `Aquarium Thermometers` - `Mini Helmets` - `RV Awnings` - `Lawn & Garden Sprayers` - `Car CD Changers` - `Selfie Sticks` - `Calibration Standard Rods` - `Lab Chromatography TLC Developing Tanks` - `Poultry Treats` - `Mechanical Pencil Refills` - `Dip Stands` - `Drinkware Accessories` - `Artist Manikins` - `Leathercraft Kits` - `Metalworking Spring Plungers` - `Marquee Signs` - `Craft Dyes` - `Wakesurf Boards` - `Pool Safety Supplies` - `Pedal Boats` - `Snack Crackers` - `Jewelry Cleaning Machines` - `Party Supply Sets` - `Other Decking & Fencing Hardware` - `Motorcycle Glasses` - `Art Smocks` - `Archery Nocks` - `Diving Regulators` - `Camera Flash Snoots` - `Martial Arts Weapon Stands` - `Automotive Wiper Nozzles` - `Tea Cozies` - `Stadium Seats & Cushions` - `Bear Protection` - `Flagpole Brackets & Mounts` - `Patio Umbrella Base Weights` - `Stretch Film & Shrink Wrap Dispensers` - `Punching Bag Hangers` - `Track Lighting Sets` - `Wheel Chocks & Stops` - `Itching & Rash Treatments` - `Automotive Rims` - `Tire Pressure Gauges` - `Hair Crimping Irons` - `Baker` - `s Helmets` - `Curtains & Valances` - `Aquarium Starter Kits` - `Body Muds` - `Body Piercing Retainers` - `Hockey Chest Protectors` - `Diving Boards` - `Small Engines` - `Pet Sofa & Chair Protectors` - `Tent Accessories` - `Pedal Covers` - `Appliance Covers` - `Vegetable Dips` - `Hockey Shin Pads` - `Acne Creams` - `Mobility Aid Steps` - `Quilting Frames` - `Water Heaters` - `Sound Pressure Level Meters` - `Glider Rocking Chairs` - `Punching Bags` - `Nail Ridge Filler` - `Yoga Gloves` - `Jewelry Stringing Materials` - `Dishwasher Rack Rollers` - `Other Hair Removal Supplies` - `Agility Ladders` - `Watch Winders` - `Blender Pitchers` - `Hand Tampers` - `Dehumidifier Accessories` - `Punch Bowl Sets` - `Mini Projectors` - `Drinkware Sets` - `Evaporated Milks` - `Spoon Rests` - `Juggling Toys` - `Mixed Spices & Seasonings` - `Bicycle Child Seats` - `Water Coolant Systems` - `Jai Alai Sets` - `Surveillance Camera Lenses` - `Chain Hoists` - `Snack Pudding & Gelatin` - `Hair Curling Wands` - `Spa Cover Lifts` - `Track Lighting Heads` - `Photo Enlargers` - `Photo Enlarger Lenses` - `Plant Cages` - `DJ Mixers` - `Condiment Servers` - `Electric Kettles` - `Glass Raw Materials` - `Radio Antennas` - `Bicycle Front & Rear Racks` - `Body Oils` - `ATV Tires` - `RAM Memory` - `Pet Toothpaste` - `Dressing Aid Sticks` - `Coconut Knives` - `Sports Pole Holders & Bases` - `Dock Steps` - `Bath Toy Storage` - `Martial Arts Belts` - `Currency Bands & Straps` - `Outdoor Playsets` - `Video Switchers` - `Brake System Replacement Parts & Hardware` - `Tennis Shorts` - `Facial Treatments` - `Athletic Compression Socks` - `Brake Booster Filters` - `Other Knitting & Crochet Supplies` - `Martini Glasses` - `Personal Organizers` - `pH Meters` - `Parchment Paper` - `Other Gift Wrapping Supplies` - `Leathercraft Accessories` - `Rod Hockey` - `House Numbers & Letters` - `Toaster Pastries` - `Anti-Chafing Creams` - `Sunshine Recorders` - `Makeup Sets` - `Baby Jumping Exercisers` - `Replacement Appliance Knobs` - `Hair Removal Waxing Strips` - `Toaster Ovens` - `Electric Crepe Makers` - `Kiteboard Control Lines` - `Camera Cleaning Equipment` - `Body Piercing Jewelry` - `Weatherproofing Pipe Coverings` - `Plant Misters` - `Rosin Bags` - `Plastic Cups` - `Baby Bouncer & Rocker Chairs` - `Washing Machines` - `Ground Coffee` - `Gun Mounts` - `Remote Controls` - `Medicine Dosing Containers` - `Chainsaw Chains` - `Climbing Slings` - `Basketball Storage` - `Writing Notebooks & Sketch Books` - `Thermometer Probe Covers` - `Wall Calendars` - `Power Tool Batteries` - `Corded Phones` - `Desk Lamps` - `Network-Attached Storage Servers` - `Slatwall Panels` - `Golf Push & Pull Carts` - `Media Storage Cabinets` - `Stovetop Waffle Irons` - `Pet Tie-Outs` - `Toilet Paper Holders` - `Boating Heads` - `Movie Cameras` - `Vanity Lights` - `Plaques & Signs` - `Decorative Bottles` - `Art Paint Sponges` - `Kayak Carts` - `Radar Detectors` - `Outdoor Bar Stools` - `Piggy Banks & Money Jars` - `Fog Machines` - `Food Storage Jars & Containers` - `Pet ID Tags` - `Salad Serving Utensils` - `Bath Rugs` - `Water Distillers` - `Sewing Bias Tape` - `Racquet Vibration Dampeners` - `Live Shrubs` - `Cable Tie Guns` - `Floating Shelves` - `Empty Camping Stove Fuel Bottles` - `Toy Billiards` - `Water Diverters` - `Powdered Baking Cocoa` - `Card Shufflers` - `Tool Sets` - `Paper Holders & Dispensers` - `Bed-in-a-Bag` - `Rail Planters` - `Glass Markers & Stemware Charms` - `Poison Ingestion Treatments` - `Sewing Baskets` - `Decorative Boxes` - `Play Tents` - `Oke Daiko Drums` - `One-Piece Swimsuits` - `Bicycle Stands` - `Photography Flash Heads` - `Yogurt Makers` - `Field Hockey Goalie Hand Protectors` - `Window Shades` - `Camera Battery Grips` - `Hunting Game Hoists & Gambrels` - `Sunglass Visor Clips` - `Christmas Trees` - `Edge & Corner Guards` - `Golf Carts` - `Screen Houses` - `Tent Poles` - `Fish Cleaning Tables` - `Bicycle Saddle Covers` - `Plant Seeds` - `Geographic Globes` - `Jewelry Making Chain` - `Figurines & Knick-Knacks` - `Binder Insert Strips` - `Hair Clipper Blades` - `Nutrition Drinks` - `Musical Bow Cases` - `Glue Guns` - `Breast Tape` - `Automotive Lift Supports` - `Acoustic Guitars` - `Therapeutic Light Boxes` - `Stovetop Espresso Pot Replacement Gaskets & Filters` - `Beverage Tubs` - `Lifeguard Swimsuits` - `Other Backpacking & Camping Supplies` - `Napkin Rings` - `Staple Removers` - `Gravy Boats, Stands & Sets` - `Bath Pillows` - `Easter Eggs` - `Cut Flowers` - `Traditional Abayas` - `Air Guns` - `Electric Fence Insulators` - `SIM Cards` - `Oven Mitts` - `Gun Barrels` - `Automotive Skid Plates` - `Sport Starter Pistols` - `Personal Misters` - `Telescope Eyepiece & Filter Sets` - `Cell Phone Radiation Guards` - `Snowmobile Riser Blocks` - `Football Target Nets` - `Memory Card Adapters` - `Mobility Walkers` - `Ice Buckets` - `Skins for Vape Pens` - `Electrical Ballasts` - `Bicycle Frames` - `Cheese Wax` - `Whole Bean Coffee` - `Tennis Rebounders` - `Plaster Hawks` - `Dance Shoes` - `Pizza Crusts` - `Other Fireplaces Accessories` - `Epoxy Coatings` - `Automotive Trailers` - `Gift Wrap Paper` - `Material Handling Securing Straps` - `Disposable Cameras` - `Small Animal Exercise Wheels` - `Hall Trees` - `Cash Boxes` - `Sprinkler Valves` - `Renewable Energy Controllers` - `Impact Drivers` - `Home Brewing Grain & Hop Bags` - `ATV Cargo Storage` - `Bicycle Derailleurs` - `Darkroom Squeegees` - `Lens Supports` - `Roller Stands` - `Breath Fresheners` - `Leaf & Plant Cleaner` - `Cricket Balls` - `Automotive Bumpers` - `Other Baby Safety Supplies` - `Confetti Poppers` - `Swimsuit Sets` - `Manual Pencil Sharpeners` - `Toilet Bowls` - `Art & Blueprint Tubes` - `Air Fryer Liners` - `Other Bicycle Parts` - `Gymnastics Hand Grips` - `Garlic Presses` - `GPS Software` - `Banana Hangers` - `Animal Grooming Scissors` - `Dining Tables` - `DAT Recorders` - `Decorative Bowls` - `Dustpans & Dustpan & Brush Sets` - `Racquet Sport Racquets` - `Lap Guitars` - `Construction Siding` - `Baking Cups` - `Hair Extensions` - `Starting Fluid` - `Chemical Solvents` - `Pet Training Pad Trays` - `Fishing Hook Sharpeners` - `Other Construction Heating & Cooling Supplies` - `Air Press Coffee Makers` - `Playground Merry-Go-Rounds` - `Clothes Iron Rests` - `Coffee Drippers` - `Microscope Mechanical Stages` - `Makeup Palettes` - `Fish Poachers & Bakers` - `Power Screwdrivers` - `Other Bowling Supplies` - `Hardware Bolts` - `Gymnastics Rings` - `Other Occupational Health` - `Automotive Glow Plugs` - `Gun Stocks` - `Ice Fishing Spearing Equipment` - `Light Timers` - `Plant Pots & Planters` - `Camera Rain Covers` - `Table Place Cards` - `Door Closers` - `Commercial Refrigerators` - `Home Brewing Beer Bottle Caps` - `Badge & ID Holders` - `Interdental Brushes` - `Facial Self-Tanners` - `Archery Finger Tabs` - `Hand Drills` - `Cooking Sauces & Marinades` - `Conductor` --- ## Walmart Category Metadata Field Mapping Use this table to understand what metadata fields are allowed for each `type` when creating items via Unified. Please note that these metadata fields are optional, while some categories do need specific metadata fields [file](https://prod-files-secure.s3.us-west-2.amazonaws.com/f6d0376b-d1d7-4f33-bff2-5d522d0db8dc/87d2c7a2-b0ec-47db-a30d-b5a3c79532e2/walmart_schema_fields.md?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=ASIAZI2LB46627OXAUV4%2F20260203%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20260203T202547Z&X-Amz-Expires=3600&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEDwaCXVzLXdlc3QtMiJHMEUCIDcwb3GqFMY%2FL0AJfL3I%2FUaV5M9rbKJANmndDNP%2B3cvWAiEAhstHrJkItWTW8LOfcwCVzrIfvRAjHLMFyJfIfDU%2Bm5kq%2FwMIBRAAGgw2Mzc0MjMxODM4MDUiDA%2BtPXgWwEeVTi9f7ircAy8POF8SwjOULjsIQSqBd%2Fb2Sb6AYRzEosiUnG56PWPmdxaHm3k3mhZ98RpFVpH8CeB7bEprhu1JjUOsHo93G6SlQ3WFnekVfwsKTtQeZInDow6JHMH%2BMGm%2BY4yrZil9HtEvuEeXCcyLOpo4qxe%2FzygCd1LK5%2FFlF%2BufoVF3BNpKp7P0MtoXnCzFWs0MFxnCNa0rC852v5sNTAEu478oOshw%2BLFPjPGr4BN3oIlmMjDzWYHZY8%2BJiaJ2aGhByPelsH3KEkQRqC%2B40w3fkPcpLH77Np6vl31a0ex%2FRk5m7EV8FvHsTcnYMhH5svt21RR24xTmDstjj2oVRm5V%2FX8eJKX6kjKslRLNhw8d2M27UCF6OpxsqOnqS1LGxnS7rvxNgYanpAvdn7NkjmYFdDeRdeHbzEeENgxu2tF8SUoaDcf1Egcyu8YwxKCbGOxPibrKF%2BDwMky3VDx2sdvpK9jJZ0Eh8xGXgUcNOrCn4%2FGCvfOFp%2FtYposVMIUDbq%2B73dBoaHWeuGS3bdKKb66PIkZKRn05sTczh%2BrDXqXKMoZQoh5OvENP9IRrAgUYEl3Xk3aBgBURjrMHYmxdMVzNN%2BnNkGj7tyub25hYezxlEGmlYb69wGyILpxLIx7xqB%2FBMM%2BYicwGOqUBB0ea%2B5PQU0cqrDMLy%2BnMl9D9nPF2C7uGR2XYiEEFZBqU%2Bi2WTYMRsjeJA2Rx%2BTujp%2BvkhiPftP12AVrIQ2PyuO5gMUOPpxef782YG8379CUFQjyGeX4Fc9kUGvXjZfX%2F4mC0EJZpzKPETzLbvwNv9JwO%2BBKTKTCtkFdhzE1QBz5NRfnV5CuPgC8GEgMgB8OV70jCGmsqhgJKqb8T0ENHV0r%2BT2Io&X-Amz-Signature=8d40af48db880c5cd5ad6117b673bf0138e774a6347b8b3f26e646322b8e3999&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) --- ### Sample Payload ```json { "name": "Wireless Earphones with Advanced Features", "slug": "09876543210987", "global_code": "06146190200012", "type": "Exterior Automotive Accessories", "description": "Totally wireless earphones are built to revolutionize your workouts. The adjustable, secure-fit earhooks are customizable for extended comfort and stability. A reinforced design for sweat and water resistance lets you take it to the next level. Each earbud has full volume and track controls and up to 9 hours of listening time to fuel your training with powerful, balanced sound.", "media": [ { "url": "https://i5.walmartimages.com/seo/onn-Wireless-Bluetooth-on-Ear-Headphones-Black-New_07de2d93-505b-4902-8366-388a3f30e3b4.9375c5690645733ec080eef3f4895f7b.jpeg" } ], "vendor_name": "Walmart", "variants": [ { "sku": "09876543210987", "weight": 0.57, "prices": [ { "price": 249.99 } ] } ], "metadata": { "productName": "Wireless Earphones with Advanced Features", "brand": "Walmart", "keyFeatures": [ "Designed to keep up with your workouts", "Reinforced design for sweat and water resistance with adjustable, secure-fit earhooks for added comfort and stability.", "Stay connected from a distance with Bluetooth technology, these wireless earphones deliver extended range and fewer dropouts.", "Powers through long hours of training" ], "countPerPack": 1, "multipackQuantity": 1, "isProp65WarningRequired": "No", "condition": "New", "has_written_warranty": "Yes - Warranty Text", "netContent": { "productNetContentMeasure": 1, "productNetContentUnit": "Each" }, "productSecondaryImageURL": [ "https://i5.walmartimages.com/seo/onn-Wireless-Bluetooth-on-Ear-Headphones-Black-New_07de2d93-505b-4902-8366-388a3f30e3b4.9375c5690645733ec080eef3f4895f7b.jpeg" ], "assembledProductLength": { "measure": 4.33, "unit": "in" }, "assembledProductHeight": { "measure": 4.33, "unit": "in" }, "assembledProductWeight": { "measure": 0.57, "unit": "lb" }, "assembledProductWidth": { "measure": 3.15, "unit": "in" }, "prop65WarningText": "No", "manufacturer": "Walmart", "manufacturerPartNumber": "WM123456", "count": 1, "warrantyText": "1 Year", "color": "Blue", "aaiaBrandID": "WMTB", "vehicle_fitment_type": "Specific" }, "options": {} } ``` **NOTE**: If item creation **fails** or takes **too long** to process, the **`feed ID`** and any **`error details`** will be returned in the error response. ⚠️ **Important Note on Reading** **`commerce_item`** **Data via Walmart's GET and LIST APIs** When using Walmart's **GET** or **LIST** endpoints to retrieve `commerce_item` records (i.e., your catalog items), **you will only receive a subset of the full item**. This limitation is imposed by Walmart's public Marketplace APIs and is not configurable. ### What's Missing? - Fields defined in the **`Visible`** section of your original item feed (e.g., `animalLifestage`, `assembledProductWeight`, `features`, `fabricContent`, etc.) will **not be returned** in full. - Walmart truncates or omits many **category-specific structured attributes**. ### Why This Happens: Walmart's GET/LIST endpoints are designed for high-level overviews or simple listing needs, not for reconstructing detailed item payloads. They surface: - Basic identifiers (e.g., SKU, productName) - Core logistics info (e.g., price, inventory, brand) - A _limited set_ of visible attributes