--- updatedAt: 2026-08-18T20:17:00.000Z --- # Item setup schema key points `MPItemFeedHeader` contains attributes that are applicable for all items in the submission. These headers are required and only need to be completed once per submission. The `MPItem` object is completed for each item submitted. Sellers can include multiple items per submission. The `MPItem` object contains the `Orderable` and `Visible` schemas. If you are setting up a WFS item, the `MPItem` object will also contain the `TradeItem` object for you to provide all your logistic and critical attributes. The `Orderable` object includes all the relevant attributes that Walmart requires to create an Offer for your item so that it may be sold on Walmart.com. The attributes included in this section may vary between Fulfillment channels (SFF vs WFS), for example, shipping dimensions are required for Seller Fulfilled Items, but Walmart Fulfilled items require `TradeItem` hierarchies. The `Orderable` object also includes the item’s primary identifier, such as its global trade item number (GTIN). ## #Request a GTIN exemption
For `MP_ITEM`, if the seller needs a GTIN exemption or already has one, set the Product ID to `CUSTOM` and keep the Product ID type as `GTIN`.
``` "productIdentifiers": { "productId": "CUSTOM", "productIdType": "GTIN" } ```
Do not use `CUSTOM` as the default Product ID for all item setup requests.

If the exemption requires manual review, the feed can reach `PROCESSED` while the item-level `ingestionStatus` remains `INPROGRESS`. Check the GTIN Exemption Status API or the GTIN Exemption Dashboard in Seller Center for the final decision. If approved, resubmit the item to complete item setup. ### `Orderable` objects During item setup, you can provide all four product package dimensions: `productPackageDimensionsDepth` (in), `productPackageDimensionsHeight` (in), `productPackageDimensionsWidth` (in), and `productPackageWeight` (lb). Product package dimensions refer to the physical measurements and weight of the original manufacturer's packaging in which a product is produced and sealed. For example, the white Apple iPhone box illustrative values: ``` "productPackageDimensionsWidth": 3.55, "productPackageDimensionsHeight": 6.90, "productPackageDimensionsDepth": 1.40, "productPackageWeight": 0.95 ``` Use these measurements for shipping, duty, and cross-border checks. These fields are optional but recommended to improve duty estimates, freight template eligibility, and cross-border readiness. Use non-negative values with up to four decimal places. The `Orderable` object can include key attributes for specific Walmart Programs. For example, to create a pre-order item, you must complete the`isPreOrder` attribute as well as the conditionally required `releaseDate` attribute. The `automate pricing` section is designed to help you automate the pricing of your items during item setup. It allows you to set up rules and boundaries so that item prices can be automatically adjusted (repriced) based on strategies and limits you define. You can select a specific pricing strategy you want to use from a list of strategies you’ve set up. Refer to the [Repricing during item setup](/us-marketplace/docs/repricing-during-item-setup) article for more information. You can either add inventory during item setup or after the item setup is completed. To add inventory for pre-order items, find the Inventory attribute in the schema and update the three associated child attributes: `Inventory Quantity`, `fulfillmentCenterID`, and `preOrderAvailableOn`. Specify the pre-order availability date for inventory using the `inventoryAvailabilityDate` attribute in the yyyy-mm-dd format. This field is required for pre-order items setup but can be left blank for non-pre-order items. All these attributes are available in the Orderable schema and are conditionally required. Refer to the [schema sample](/us-marketplace/docs/post-item-setup-by-product-type-feed-file-structure-overview). To add inventory for non-pre-order items, provide values for the Inventory Quantity, and fulfillmentCenterID attributes in the Orderable schema. It’s very important to remember to check your submission to make sure all the Conditionally Required attributes have been filled out completely before submitting your entry. **NOTE**: Enrollment is required for Pre-Order, Pre-Owned, and Restored programs. The `Orderable` object includes the `countryOfOriginSubstantialTransformation`, COO attribute, which identifies where an item was manufactured or produced. This is a mandatory attribute to determine duties, taxes, tariffs, and restrictions for cross-border shipments at the time of item setup. The COO is required for future programs and if not specified, an error will be displayed in the [Feed item status API](/us-marketplace/reference/getfeeditemstatus). In the `Visible` object, the seller must define the product type being set up. Based on the product type selected, the seller will complete the relevant attributes as identified in the feed file schema provided. Based on the chosen Product Type, attribute requirements, values, and recommendations will vary. Additionally, if you’re using API specification version [MP\_ITEM-5.0.20240517-04\_08\_27](/file/mp/us/MP_ITEM-5.0.20240517-04_08_27-api.zip), to create a Restored item, you must add the refurbished product identifier (GTIN, UPC, EAN) into the `productID` field. `restoredProductIdentifier` attribute is not available in the [old specifications](/file/mp/us/MP_ITEM-5.0.20240517-04_08_27-api.zip). If you’re using the [latest API specifications](/file/mp/us/MP_ITEM-5.0.20241118-04_39_24-api.zip), to create a Restored item, you must add the refurbished product identifier (GTIN, UPC, EAN) into the `productId` and the `restoredProductIdentifier` fields. The value in these two fields must match. Failure to submit both fields will result in an error. For exclusive Product Types such as Trading Cards, Trading Card Games, Comics, Coins, Collectible Ephemera, and Autographed Collectibles, the following attribute rules apply: * Collectible Grading Type attribute is required. * The Condition attribute is required only if Collectible Grading Type is `New` or `Ungraded`. * The Grading Company and Collectible Grade attributes are required if Collectible Grading Type is `Graded`. * The Certificate Number attribute is recommended if Collectible Grading Type is `Graded`. Refer to the [Collectibles item setup ](/us-marketplace/docs/collectibles-item-setup) article for more information. ### `Visible` object The `Visible` object may also contain key attributes for certain invite-only programs, such as Walmart Restored and Pre-Owned programs. If you’re participating in these programs, the `Condition` attribute is required, where you specify the item’s condition type. Add this information to indicate the state of your item, its level of wear, prior use (if any), appearance and overall quality of your items. Refer to the [WFS schema example in this article](/us-marketplace/docs/post-item-setup-by-product-type-feed-file-structure-overview). ### `tradeItem` object Attributes for the `tradeItem` object are only used for WFS. The item configurations defined in this section allow your items to have orders placed and be received by the Walmart Fulfillment centers. The Product ID GTIN and dimension attributes for `each` are the only required attributes to successfully submit a WFS item. Make sure to provide `each` package dimensions and quantity for the item. The `Orderable` and `Visible` objects will contain the same item data, but each sellable `TradeItem` configuration will be independent of the trade item objects. ## WFS Convert If you're converting a Pre-Owned item from seller-fulfilled to WFS, make sure to include its `Condition` in the request. * This is a required attribute, and the value must match the exact condition of the original seller fulfilled item. * The item condition is an immutable attribute. If the condition differs from the original seller fulfilled listing, the conversion will fail. * Allowed condition values vary by product type. To learn more about supported condition types, refer to the [Item condition types](https://marketplacelearn.walmart.com/guides/Item%20setup/Restored%20or%20Pre-Owned%20items/Item-condition-types). The `Orderable` object contains three required attributes for regulated product types – `isChemical`, `isAerosol`, and `isPesticide`. If any of these attributes is set to `yes`, a Safety Data Sheet (SDS) is conditionally required to meet compliance, labeling, and shipping standards. Additionally, if `isPesticide` is set to `yes`, the `pesticide_type` attribute becomes conditionally required. Valid values for `pesticide_type` include: EPA Registered Pesticide, Pesticide Device, Minimum Risk 25(b), Treated Article.