Creating Walmart Items via Unified

Updated:


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

FieldDescription
typeThis 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_codeThis is your product's GTIN (Global Trade Item Number), a required identifier for Walmart. It must be a valid 12–14 digit string.
metadataA 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

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


Sample Payload

{
  "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
Share
All guidesAccounting Account Type Hierarchy in UnifiedAdvertising Report Metrics by IntegrationAmazon S3: Required IAM PermissionsATS to Vector DB: How to Power Talent Intelligence with Real-Time DataBuilding AI applications with Unified and LangbaseConcur & Concur (Company) — Connection GuideConfigure Greenhouse Native Candidate WebhooksConfigure Salesforce Meetings and Notes for UnifiedConnect Amazon Seller Central to Unified.toConnecting BambooHR via OAuth 2Connecting Google Workspace Integrations with a Service AccountCorrect WelcomeKit Scopes for Jungle IntegrationCreating Ads using the Unified Ads APIEnd-Users, Integrations, and ConnectionsEnriching Unified Objects with Custom MetadataEnterprise-managed authorization (EMA) with a static keyEnterprise-managed authorization (EMA) with a workspace secretEnterprise-managed authorization (EMA) with Microsoft Entra IDExtended observability — pushing API logs to ClickHouseExtended observability — pushing API logs to Grafana / LokiExtended Observability - Pushing API Logs to your Datadog InstanceFacebook Messenger Webhook SetupFireflies Integration GuideGetting started with WorkableHandling Delegated vs. Application Scopes in Microsoft IntegrationsHiBob & Unified: connection and time off guideHow long are logs retainedHow to access employees and usersHow to add API support for the Create Activity in CrelateHow to Associate a Connection ID with Your End-UserHow to build a Candidate Assessment product withHow to build a candidate sourcing or job board app with Unified.toHow to build a Discord support bot with Unified.to and LangbaseHow to Build a Fintech Application with Unified's Payments APIHow to Build an E-Commerce Product Integration with UnifiedHow to build an invoicing system with Unified.toHow to build Enterprise Search using RAGHow to configure Bullhorn Redirect URI for creating a connectionHow to configure webhooks in HubSpotHow to configure webhooks in Thrive LearningHow to configure webhooks in Toast for UnifiedHow to Connect Anthropic to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect Cohere to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect Google Gemini to Real-Time SaaS Data with Unified.to MCP ServerHow to connect HiBob (Bob) to Unified with OAuth 2.0How to Connect LLMs to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect OpenAI to Real-Time SaaS Data with Unified.to MCP ServerHow to Connect Zoom and Zoom PhoneHow to create a Connection In Microsoft TeamsHow to create a token-based connection in HighlevelHow to Create a Unified.to Connection to HighLevelHow to Create a Xero Connection in Unified.toHow to create and configure webhooksHow to create Connection with HubspotHow to customize portal URLs for Stripe and GoCardlessHow to filter webhook eventsHow-to Get a Private Support Channel for Your Unified IntegrationHow to get help fromHow to get your 8x8 Connect API Key, Account ID and SMS Subaccount ID (optional): Step-by-step guideHow to get your ADP Workforce Now Oauth2 client ID, Oauth2 client secret, Oauth2 PEM certificate and Oauth2 private key: Step-by-step guideHow to get your Amazon S3 AWS Region, AWS S3 Key, AWS S3 Secret and AWS S3 Bucket(s) (optional, comma-separated): Step-by-step guideHow to get your Ashby API Key: Step-by-step guideHow to get your Brex API token: Step-by-step guideHow to get your Bullhorn OAuth2 Client ID, OAuth2 Client Secret, API Username and API Password: Step-by-step guideHow to get your Ceridian Dayforce Username, Password and Client Namespace: Step-by-step guideHow to get your Crelate API key: Step-by-step guideHow to get your Dashlane API Key: Step-by-step guideHow to get your Deel Access Token: Step-by-step guideHow to get your Dialpad API Key: Step-by-step guideHow to get your Discord OAuth 2 credentials and bot tokenHow to get your ELMO client ID and client secret: Step-by-step guideHow to get your Gainsight Client ID, Client Secret and Gainsight API Domain: Step-by-step guideHow to get your Greenhouse API Key and Job board token: Step-by-step guideHow to get your Helpscout API Key: Step-by-step guideHow to get your HiBob Service User ID and Service User Token: Step-by-step guideHow to get your HighLevel API Key and Location ID: Step-by-step guideHow to get your HubSpot developer key and OAuth 2 credentials (Legacy Apps)How to get your Humaans API Key: Step-by-step guideHow to get your iCIMS API Username, API Password and Customer ID: Step-by-step guideHow to get your JobDiva Client ID, Username/email and Password: Step-by-step guideHow to get your Jobvite API Key, API Key Secret and Email: Step-by-step guideHow to get your Lever API Key: Step-by-step guideHow to get your Loxo Agency slug, API Key and Agency ID: Step-by-step guideHow to get your Microsoft Active Directory / Entra ID Client ID, Client Secret and Tenant ID: Step-by-step guideHow to get your Microsoft Azure AD OAuth 2 credentialsHow to get your OAuth 2 credentials for GmailHow to get your OAuth 2 credentials for Microsoft Dynamics 365How to get your OAuth 2 credentials in PipeDriveHow to get your OpenAI API Key: Step-by-step guideHow to get your Paycom SID/Username and Token/Password: Step-by-step guideHow to get your PCRecruiter Username, Password, Database ID, App Key and App ID: Step-by-step guideHow to get your SAP SuccessFactors (OpenID Connect) Username, Password, Client ID, Client Secret, Dependency Name, IAS Host and API URL: Step-by-step guideHow to get your SAP SuccessFactors Username, Company ID, Password and API URL: Step-by-step guideHow to get your Shopify Admin API access token and Store ID: Step-by-step guideHow to get your Wayfair Client ID, Client Secret and Vendor Encrypted Key: Step-by-step guideHow to get your Workable API Token and Subdomain: Step-by-step guideHow to get your yotpo APP Key / Store ID and Secret Key: Step-by-step guideHow to Handle Attachments in Invoice, Bill and Credit MemoHow to Manage Google Ad Manager Orders, Line Items and Creatives with theHow to migrate or import your integrations into Unified.toHow to obtain your GitHub OAuth2 credentialsHow to Power Claude with Live Customer Data Using Unified MCPHow to receive assessment orders from an ATS with Unified.toHow to register a Google developer app and get OAuth 2 credentialsHow to Register a HiBob Developer App and Get OAUTH2 CredentialsHow to register a Salesforce developer app and get OAuth 2 credentialsHow to register a Slack developer account and get OAuth 2 credentialsHow to Register a Workday Developer App and Get OAUTH2 CredentialsHow to Register a Workday Developer App and Get OAUTH2/ SOAP CredentialsHow to Register a ZendeskSell Developer App and Get OAUTH2 CredentialsHow to Register a Zoho Developer App and Get OAUTH2 CredentialsHow to Register an ADP Developer App and Get OAUTH2 CredentialsHow to Register an Atlassian Developer App and Get OAUTH2 CredentialsHow to Register your Facebook OAuth2 ApplicationHow to Register your Google Ads OAuth2 ApplicationHow to Register your MetaAds OAuth2 applicationHow To Request & Write Raw Integration DataHow to Retrieve Microsoft Dynamics 365 Business Central CredentialsHow to set up a custom API URL with a CNAMEHow to Set Up a Google Meet Meeting Bot with UnifiedHow to set up a HiBob marketplace installHow to Set Up a Microsoft Teams Bot with UnifiedHow to Set Up a Microsoft Teams Meeting Bot with UnifiedHow to Set Up a Webex Meeting Bot with UnifiedHow to Set Up a Zoom Meeting Bot with UnifiedHow to set up and configure NotionHow to set up Google Business Profile API access and get OAuth 2 credentialsHow to Set Up LinkedIn Webhooks with UnifiedHow to set up native webhooks for QuickBooks Online with UnifiedHow to set up Slack webhooks using event subscriptionsHow to set up Telegram (bot) with Unified.toHow to set up your scopes in HubSpotHow to setup a Freshbooks developer appHow to setup a TikTok Shop applicationHow to Setup AWS Assume Role for AWS Secret ManagerHow to setup Oracle JD EdwardsHow to Setup Quickbooks DesktopHow to setup Sage 100 with Unified.toHow to test webhooks in the Synthetic Data (Sandbox) environmentHow to troubleshoot unhealthy connectionsHow to troubleshoot unhealthy webhooksHow to Use Decision Models with the Unified GenAI APIHow to use SCIM with the Unified APIHow to use the Passthrough APIHow to Use Unified.to's Generative AI API with OpenAI and ClaudeHow to use User Provisioning and Verification with UnifiedHow virtual webhook retry and recovery worksIntegration set-up guide for LeverManaging custom validation rules in SalesforceNetSuite Authentication Setup for UnifiedNotice of Deprecation of Fields and Objects (Nov 2025)Oracle HCM / Taleo OAuth Credentials GuideRetrieval-Augmented Generation (RAG)SalesForce (External Client Apps) on Multiple OrganizationsSAML Single-Sign-OnScaling MCP Tools with Anthropic's (& OpenAI's) Defer LoadingScaling MCP Tools with Anthropic's Programmatic Tool CallingSet Environments for your Unified.to WorkspaceSetting up a Slack Bot Connection with Unified.toSetting up OAuth 2 Credentials for Greenhouse's APIsTrello Connection Guide in UnifiedUnderstanding OAuth2 Authorization flowsUnderstanding Response Time Headers in the Unified APIUnified Assessment API: Embed Assessments Inside ATS PlatformsUnified's MCP ServerUnified MCP Server with LangChain and LangGraphUnlock real-time data with virtual webhooksUse Unified to sign in your users into your applicationVincere OAuth Setup Guide for UnifiedWhy you can't use Unified's OAuth2 credentials to authorize your end users on ProductionWorkable: Creating candidates and attaching them to jobsWorkday vs Workday Legacy — Why Unified.to Supports BothWorking with hierarchical tree data in Storage, Messaging, and KMS APIs
Are we missing anything? Let us know
Was this page helpful?