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_accessoriesallows fields likeanimalType,petSize,isFoldable,colorCategory, etc.computersallows fields likeprocessorType,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 RisersBaby Play YardsPower Hedge TrimmersEyeglass CasesMicrophone SplittersElectric Buffet ServersRadio Control Vehicle ServosSticky NotesMatcha Tea Bowls & WhisksDoughsTaffy CandyHair DryersBase LayersEmergency LightingBidet Toilet SeatsPurse Making SuppliesGrill Grid LiftersHunting ScentsAutomotive Headlight RestorerEar Thermometer Replacement Lens FiltersGlassware & DrinkwarePrecious MetalsLab Chromatography PaperPlant TerrariumsMicrophone CablesGlucose SupplementsSnow SkisPerineal CleansersSoda Maker KitsCamera Accessory BundlesTetherball EquipmentPaint Reducers & RetardersPork RindsPortable Basketball SystemsPlate JoinersOther Weight Loss SuppliesPowder CandyOutdoor Kitchen Serving & Storage CartsUnitards & LeotardsLab Sample BagsFishing Rod & Reel CombosAdhesive TapesTrack & Field MarkersFruit & Vegetable CorersAutomotive Fuel Tank CapsDrawing BoardsHand DryersPregnancy TestsCat Litter MatsFacial WipesExercise WeightsSewing PinsOther Makeup Brushes & ToolsOther Shaving SuppliesSugar Packet HoldersHoney DippersArtificial TopiariesCupcake Making KitsMobility Walker Bags, Baskets & CarriersFaucet Water FiltersUrinary Tract Infection Test StripsBaptism Gowns & OutfitsFunction GeneratorsFM TransmittersHome Brewing RefractometersSaddle BagsTrack & Field Competitor NumbersFuel DistributorsNicotine PatchesGriddles & Grill PansPlanter & Stand SetsOther Pet Health SuppliesScooter DecksKnitting & Crochet Stitch CountersCamera Tool KitsEyelash CombsBlouses & TopsKnitting & Crochet Stitch MarkersHand Tool PunchesClimbing Rappel DevicesKitchen TowelsHomogenizer AccessoriesAttendance Time CardsDigital Camera PartsPlanners & Appointment Book RefillsHerbal SupplementsHand-Sewing NeedlesWeight BarsPhotography FixersMassage Table Carrying CasesGrill CoversOther Skating SuppliesMaple SyrupsPizza Stones & PansManual Letter OpenersWater GunsManual Can OpenersElectronic TouchpadsString Trimmer Replacement PartsBaby Bodysuits & One-PiecesWalking Cane & Crutch TipsCutting MatsThrowing KnivesSkins for TabletsServing Utensils & SetsPhotographic ArtSoap Making KitsAthletic Shirts & TopsTicket RollsFireplace BellowsTravel Plug AdaptersVacuum SealersSmall Animal Habitat DecorVacuum TubesStroller ConnectorsCeiling FansOther Dancing SuppliesModel Train LocomotivesElectronic Cigarette Starter KitsBicycle BasketsGolf VisorsBicycle Storage HooksHandheld Video GamesCocktail MixersFollow-Focus LeversEmbossing ToolsIncentive ChartsPressure GaugesArt Paints & Pigment PowdersReplacement Water FiltersMoisture MetersOther Pet Grooming SuppliesShopping Cart & High Chair CoversNursing PillowsDisposable Cutlery SetsHeat GunsConstruction FlashingAutomotive Aerodynamics KitsFire RetardantsGun SnakesSnow Removal Rakes & Hand PushersCostume WigsOutdoor Decorative StonesLip StainsWorkwear Uniform BadgesGut Health TestsCarbon Monoxide AlarmsCable CoversLathe Cylindrical RollersHamburger Patty MakersPrinting Press AccessoriesAutomotive Light Covers & GuardsOverbed TablesArtwork Cases & PortfoliosDisposable Storage BagsFootball HelmetsAutomatic Transmission FiltersLive TreesUmpire Leg GuardsLine ConditionersCup & Saucer SetsRain BarrelsS,s TapesIndoor FireplacesHeadphone CasesBattery TestersFloor Hockey CartsT-ShirtsDunun DrumsSpeed ReducersPercussion MalletsPallet CoversTelescope CasesAutomotive GrillesFencing Sport Epee PartsEmergency Food KitsSports Corner FlagsBird Nests & Nesting MaterialBoxing RingsPaper SortersLollipop & Treat SticksCabin Air FiltersPool CoversVideo Game Dance PadsFootball Sleds & ChutesClay & Dough Extruders & PressesBaseball Gloves & MittsYeasts & LeavenersSkins for Aerial DronesReplacement Faucet Water FiltersOther Electronic Components & AccessoriesLab CoatsLaser DetectorsBaseball Sliding ShortsHunting Game FindersRain & Snow GaugesShapewear BodysuitsToiletry Kits & BagsPhoto Enlarger HeadsAthletic Outfit SetsCombustion AnalyzersPersonal Organizer Refills & AccessoriesHarmonic ExcitersBilliard Table FeltVideo Game Console PartsHam Radio TransceiversBaby JuicesHot Dog MachinesPipe Inspection CamerasMisting SystemsSleeping Bag LinersKids Gardening ToolsCamera Film WindersOther Billiard SuppliesErgonomic BackrestsBalloon PumpsLump CharcoalsPilates BarrelsSurfing LeashesDart ShaftsMakeup Blotting PaperEye MasksWelding HelmetsElectronic CoilsEnergy DrinksPush-Up StandsPhotography Stop BathsHandbag Hook HangersNetwork Security DevicesStitch HoldersBicycle PegsOutdoor DaybedsParty FavorsCanning KitsMolding & Casting Materials & KitsMusical Instrument BodiesOther GamesElectrolyte SolutionsFruit & Wine Crushers & DestemmersPower InvertersJewelry Jump Rings & Split RingsTable Tennis PaddlesSIM Card Backup DevicesTie PinsBilliard TablesArchery BroadheadsVehicle WindshieldsJock StrapsPet Live AnimalsDC-to-DC ConvertersTransport DrumsVinyl FiguresEntertainment CentersFireplace ToolsServing ForksNut SplittersBlasters & Foam PlayGarden Border EdgingGun Holsters & HoldersSpice Racks & OrganizersStamps & Stamp SetsUdu DrumsReception Chairs & SeatingPepper & PeppercornsGolf DriversCC CreamYoga SocksVacuum Cleaner AttachmentsPlanter LinersPie & Pastry FillingsBed SkirtsDart Carrying Cases & WalletsPizza OvensCrepe SpreadersHex ToolsStretch Film & Shrink WrapMassage HeadrestsElectronics Carrying CasesDust CollectorsDecorative StonesYoga StrapsEspresso MachinesLab Face Masks & ShieldsGuitar Effects PedalsHockey Hip PadsPressure Cookers & CannersDiabetic Foot CareNail Top CoatWax Molding MaterialsDock GuardsDecoupage Tools & SetsRugby BallsBra Back AdaptersOther Backyard Wildlife SuppliesFood PeelersModular SynthesizersMirror BallsCricket WicketsSnatch Rigging BlocksRowing ShellsStaple Gun StaplesGolf RangefindersWaterbed LinersBeer GlassesKVM SwitchesPanel CarriersSanding FramesFirst Aid TapeHand Pruners & LoppersReusable Training PantsOutdoor SpasAir Hockey PucksCat TreesSurgical GownsBaseball Protective ScreensArtificial PlantsBasting BrushesArchery ArrowsCalibration WeightsLaptop ComputersChalkboard ChalkNasal AspiratorsInstant CoffeeVanity Tables & Table & Bench SetsPrinter DrumsAutomotive Body PaintParaffin Treatment Hand & Foot MittsStovetop Espresso PotsRobotic Lawn MowersPhone GripsHammock ChairsHome Brewing Kegs & Keg SuppliesDishwasher Rack AdjustersSculpting Tools & KitsMattocks & PickaxesWatch & Clock HandsUmpire BagsOther Lighting AccessoriesLab Shaker AccessoriesPrint ServersHome Brewing Beer Bottle TreesFootball Hand WarmersSpectrum AnalyzersHair Perms & TexturizersLab Glassware WashersTrailer Weight Distributing SystemsDigital CamerasDrum & Pail MixersPorch SwingsGun Choke TubesPet Milk ReplacersFabric PaintsOther Kiteboarding AccessoriesPaper CupsBottle PourersGolf Divot ToolsAquarium Cleaning ToolsFishing Vest & PacksDie-Cut CartridgesKiteboard Control BarsWelding TipsFood TongsCorn & Callus Remover CushionsCocktail ShakersInspection MirrorsFruit SnacksKayak Storage RacksCycling VestsField Hockey GogglesBreathalyzer Alcohol MonitorsDry Erase MarkersRacquet Sport Stringing MachinesGun SwivelsPower Tool ChargersHome Brewing Sanitization KitsIce Cream, Sorbet & Frozen YogurtUnderwater CamerasHair Color Stain ShieldsRoof Gutter AccessoriesBicycle Brake RotorsRepinique DrumsCamera Film Backs & HoldersAutomotive Cigarette Lighters & PlugsMeal KitsLathe Cole JawsPBX Phone SystemsFace SerumsExercise TreadmillsLawn SweepersSunglasses Replacement LensesPipe Fitting ReducersMicrophone Pop FiltersMiniDisc PlayersAudio/Video CablesHand SanitizersNail PullersTraditional Salwar KameezOther Air Tool AccessoriesCymbal PadsAutomotive Winch Mounting SystemsLaptop BagsContour Makeup SetPuzzle CubesPlant CoversEmpty Paint CansTableware KnivesStorage ShedsWindow & Door FramesPaper PlatesCalculator AccessoriesShaving SetsMicrophone PreamplifiersBaby Feeding ChairsRain PonchosAquarium ThermometersMini HelmetsRV AwningsLawn & Garden SprayersCar CD ChangersSelfie SticksCalibration Standard RodsLab Chromatography TLC Developing TanksPoultry TreatsMechanical Pencil RefillsDip StandsDrinkware AccessoriesArtist ManikinsLeathercraft KitsMetalworking Spring PlungersMarquee SignsCraft DyesWakesurf BoardsPool Safety SuppliesPedal BoatsSnack CrackersJewelry Cleaning MachinesParty Supply SetsOther Decking & Fencing HardwareMotorcycle GlassesArt SmocksArchery NocksDiving RegulatorsCamera Flash SnootsMartial Arts Weapon StandsAutomotive Wiper NozzlesTea CoziesStadium Seats & CushionsBear ProtectionFlagpole Brackets & MountsPatio Umbrella Base WeightsStretch Film & Shrink Wrap DispensersPunching Bag HangersTrack Lighting SetsWheel Chocks & StopsItching & Rash TreatmentsAutomotive RimsTire Pressure GaugesHair Crimping IronsBakers HelmetsCurtains & ValancesAquarium Starter KitsBody MudsBody Piercing RetainersHockey Chest ProtectorsDiving BoardsSmall EnginesPet Sofa & Chair ProtectorsTent AccessoriesPedal CoversAppliance CoversVegetable DipsHockey Shin PadsAcne CreamsMobility Aid StepsQuilting FramesWater HeatersSound Pressure Level MetersGlider Rocking ChairsPunching BagsNail Ridge FillerYoga GlovesJewelry Stringing MaterialsDishwasher Rack RollersOther Hair Removal SuppliesAgility LaddersWatch WindersBlender PitchersHand TampersDehumidifier AccessoriesPunch Bowl SetsMini ProjectorsDrinkware SetsEvaporated MilksSpoon RestsJuggling ToysMixed Spices & SeasoningsBicycle Child SeatsWater Coolant SystemsJai Alai SetsSurveillance Camera LensesChain HoistsSnack Pudding & GelatinHair Curling WandsSpa Cover LiftsTrack Lighting HeadsPhoto EnlargersPhoto Enlarger LensesPlant CagesDJ MixersCondiment ServersElectric KettlesGlass Raw MaterialsRadio AntennasBicycle Front & Rear RacksBody OilsATV TiresRAM MemoryPet ToothpasteDressing Aid SticksCoconut KnivesSports Pole Holders & BasesDock StepsBath Toy StorageMartial Arts BeltsCurrency Bands & StrapsOutdoor PlaysetsVideo SwitchersBrake System Replacement Parts & HardwareTennis ShortsFacial TreatmentsAthletic Compression SocksBrake Booster FiltersOther Knitting & Crochet SuppliesMartini GlassesPersonal OrganizerspH MetersParchment PaperOther Gift Wrapping SuppliesLeathercraft AccessoriesRod HockeyHouse Numbers & LettersToaster PastriesAnti-Chafing CreamsSunshine RecordersMakeup SetsBaby Jumping ExercisersReplacement Appliance KnobsHair Removal Waxing StripsToaster OvensElectric Crepe MakersKiteboard Control LinesCamera Cleaning EquipmentBody Piercing JewelryWeatherproofing Pipe CoveringsPlant MistersRosin BagsPlastic CupsBaby Bouncer & Rocker ChairsWashing MachinesGround CoffeeGun MountsRemote ControlsMedicine Dosing ContainersChainsaw ChainsClimbing SlingsBasketball StorageWriting Notebooks & Sketch BooksThermometer Probe CoversWall CalendarsPower Tool BatteriesCorded PhonesDesk LampsNetwork-Attached Storage ServersSlatwall PanelsGolf Push & Pull CartsMedia Storage CabinetsStovetop Waffle IronsPet Tie-OutsToilet Paper HoldersBoating HeadsMovie CamerasVanity LightsPlaques & SignsDecorative BottlesArt Paint SpongesKayak CartsRadar DetectorsOutdoor Bar StoolsPiggy Banks & Money JarsFog MachinesFood Storage Jars & ContainersPet ID TagsSalad Serving UtensilsBath RugsWater DistillersSewing Bias TapeRacquet Vibration DampenersLive ShrubsCable Tie GunsFloating ShelvesEmpty Camping Stove Fuel BottlesToy BilliardsWater DivertersPowdered Baking CocoaCard ShufflersTool SetsPaper Holders & DispensersBed-in-a-BagRail PlantersGlass Markers & Stemware CharmsPoison Ingestion TreatmentsSewing BasketsDecorative BoxesPlay TentsOke Daiko DrumsOne-Piece SwimsuitsBicycle StandsPhotography Flash HeadsYogurt MakersField Hockey Goalie Hand ProtectorsWindow ShadesCamera Battery GripsHunting Game Hoists & GambrelsSunglass Visor ClipsChristmas TreesEdge & Corner GuardsGolf CartsScreen HousesTent PolesFish Cleaning TablesBicycle Saddle CoversPlant SeedsGeographic GlobesJewelry Making ChainFigurines & Knick-KnacksBinder Insert StripsHair Clipper BladesNutrition DrinksMusical Bow CasesGlue GunsBreast TapeAutomotive Lift SupportsAcoustic GuitarsTherapeutic Light BoxesStovetop Espresso Pot Replacement Gaskets & FiltersBeverage TubsLifeguard SwimsuitsOther Backpacking & Camping SuppliesNapkin RingsStaple RemoversGravy Boats, Stands & SetsBath PillowsEaster EggsCut FlowersTraditional AbayasAir GunsElectric Fence InsulatorsSIM CardsOven MittsGun BarrelsAutomotive Skid PlatesSport Starter PistolsPersonal MistersTelescope Eyepiece & Filter SetsCell Phone Radiation GuardsSnowmobile Riser BlocksFootball Target NetsMemory Card AdaptersMobility WalkersIce BucketsSkins for Vape PensElectrical BallastsBicycle FramesCheese WaxWhole Bean CoffeeTennis ReboundersPlaster HawksDance ShoesPizza CrustsOther Fireplaces AccessoriesEpoxy CoatingsAutomotive TrailersGift Wrap PaperMaterial Handling Securing StrapsDisposable CamerasSmall Animal Exercise WheelsHall TreesCash BoxesSprinkler ValvesRenewable Energy ControllersImpact DriversHome Brewing Grain & Hop BagsATV Cargo StorageBicycle DerailleursDarkroom SqueegeesLens SupportsRoller StandsBreath FreshenersLeaf & Plant CleanerCricket BallsAutomotive BumpersOther Baby Safety SuppliesConfetti PoppersSwimsuit SetsManual Pencil SharpenersToilet BowlsArt & Blueprint TubesAir Fryer LinersOther Bicycle PartsGymnastics Hand GripsGarlic PressesGPS SoftwareBanana HangersAnimal Grooming ScissorsDining TablesDAT RecordersDecorative BowlsDustpans & Dustpan & Brush SetsRacquet Sport RacquetsLap GuitarsConstruction SidingBaking CupsHair ExtensionsStarting FluidChemical SolventsPet Training Pad TraysFishing Hook SharpenersOther Construction Heating & Cooling SuppliesAir Press Coffee MakersPlayground Merry-Go-RoundsClothes Iron RestsCoffee DrippersMicroscope Mechanical StagesMakeup PalettesFish Poachers & BakersPower ScrewdriversOther Bowling SuppliesHardware BoltsGymnastics RingsOther Occupational HealthAutomotive Glow PlugsGun StocksIce Fishing Spearing EquipmentLight TimersPlant Pots & PlantersCamera Rain CoversTable Place CardsDoor ClosersCommercial RefrigeratorsHome Brewing Beer Bottle CapsBadge & ID HoldersInterdental BrushesFacial Self-TannersArchery Finger TabsHand DrillsCooking Sauces & MarinadesConductor
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
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
Visiblesection 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