Item spec: versioning and diff reporting

Managing item specifications across multiple marketplaces is critical for accurate product setup and maintenance. Walmart provides detailed item spec requirements for each region to help you integrate efficiently and stay compliant with evolving standards.

This article consolidates item specification resources for the U.S., Canada, Mexico, and Chile marketplaces. Each section includes:

  • Feed types supported in that marketplace
  • Latest item specifications with download links for all marketplaces
  • Previous versions and change reports for quick comparison (Market availability: US only) item specs for quick comparison and reports to track changes (Market availability: US only)

Use these resources to ensure your integration aligns with the latest spec requirements. Expand the relevant section below to access the complete tables and documentation.

US

You can download item specification requirements for various feed types. The table below provides links to download the complete item spec requirements for 6,700 product types simultaneously. You can access both the latest and previous versions of the specifications to quickly compare which version you've integrated with and troubleshoot any issues on your end.

Use the Report Type column to review changes from the previous version of the spec to the latest recommended version. The diff report excludes versions that are not recommended. Walmart provides diff reports with each update to the item spec. Make sure to check this section regularly to capture all changes in item setup requirements. For example, the 4.X to 5.X Diff Report explains the changes between versions 4.X and 5.X, simplifying the 5.X migration process.

The following table provides detailed specifications and feed types for managing item setup and maintenance in the U.S. Marketplace. It includes recommended versions, previous versions, and related reports to ensure compliance with the latest standards.

Show table
Item SpecsFeed TypeRecommended VersionPrevious VersionNot RecommendedDiff Report Type
Offer setup by matchMP_ITEM_MATCHMP_ITEM_MATCHv4.2Not applicableNot applicableNot applicable
Create new items for MP (SFF fulfilled)MP_ITEM5.0.20260330-14_47_14-api5.0.20260304-22_45_32-api5.0.20260205-21_38_48-apiMP Item spec version report
Maintain existing Items for MP (SFF) and WFSMP_MAINTENANCE5.0.20260330-14_47_14-api5.0.20260304-22_45_32-api5.0.20260205-21_38_48-apiMP maintenance spec version report
Create new items for WFSMP_WFS_ITEM5.0.20260330-14_47_14-api5.0.20260304-22_45_32-api5.0.20260205-21_38_48-apiWFS item spec version report
Convert existing item to WFSOMNI_WFS5.0.20260330-14_47_14-api5.0.20260304-22_45_32-api5.0.20260205-21_38_48-apiWFS convert spec version report
Bulk item deleteDELETE_ITEM5.0.20260330-14_47_14-apiNot applicableNot applicableNot applicable
Category mapping updatesNot applicableNot applicableNot applicableNot applicableMigration documentation
4.X to 5.X Diff ReportAllNot applicableNot applicableNot applicableMigration documentation
  • Fitment ACES XML file
  • Fitment ACES XLSX file
FITMENT_ACESACES-XML-sampleACES-XLSX-sampleNot applicableNot applicableNot applicable
Fitment PIES sample fileFITMENT_PIESPIES-sample-fileNot applicableNot applicableNot applicable

Canada

This table outlines the item specification requirements and feed types for the Canada Marketplace. Use the recommended versions and associated documentation to maintain accuracy and consistency in your product listings.

Show table
Item SpecsFeed TypeLatest Version
Offer setup by matchMP_ITEM_MATCHCA_MP_ITEM_MATCH.json
Create new items for MP 4.XMP_ITEM_INTL CA_MP_ITEM_INTL_SPEC.json.
Maintain existing Items for MPMP_MAINTENANCE CA_MP_MAINTENANCE_SPEC.json
Create new items for WFSOMNI_WFSSETUPCA_OMNI_WFSSETUP
Convert items for WFSOMNI_WFSCONVERTCA_OMNI_WFSCONVERT

Mexico

Below is a comprehensive reference for item specs and feed types applicable to the Mexico Marketplace. It highlights recommended versions and migration resources to help streamline your integration process.

Show table
Item SpecsFeed TypeLatest Version
Offer setup by matchMP_ITEM_MATCHMX_MP_ITEM_MATCH.json
Create new items for MP 4.XMP_ITEM_INTL MX_MP_ITEM_INTL_SPEC.json.
Maintain existing Items for MPMP_MAINTENANCE MX_MP_MAINTENANCE_SPEC.json
Create new items for WFSOMNI_WFSSETUPMX_OMNI_WFSSETUP
Convert items for WFSOMNI_WFSCONVERTMX_OMNI_WFSCONVERT

Chile

This table provides item specification requirements and feed types for the Chile Marketplace. Use the latest versions of the specs to ensure accurate item setup and maintenance. Review the provided documentation links to stay compliant with regional standards and streamline your integration process.

Show table
Item SpecsFeed TypeLatest Version
Offer setup by matchMP_ITEM_MATCHCL_MP_SETBY_MATCH_SPEC.json
Create new items for MP 4.XMP_ITEM_INTLCL_MP_ITEM_INTL_SPEC.json
Maintain existing Items for MPMP_MAINTENANCECL_MP_MAINTENANCE_SPEC.json