Collectibles item setup

You can use the Item Management APIs to set up collectible items with accurate listing attributes to improve item discoverability and enhance the customer experience.

Program eligibility

To list collectible items, sellers must be approved for the Collectibles program by Walmart. Sellers not approved for the program will receive item setup errors and will be unable to edit existing collectible listings.

To apply:

  1. Go to Seller Center.
  2. Open the Growth menu. This is an invite-only option available to approved sellers.
  3. Select Exclusive Programs. This is an invite-only option available to approved sellers.
  4. Click Apply.

Required Collectible attributes

  • Collectible Grading Type
  • Grading Company
  • Collectible Grade
  • Condition

Collectible Grading Type:

The collectible_grading_type attributes let you correctly list the condition of your collectible.

  • New: Sealed box, brand new, typically includes a GTIN. Example: Pokémon cards.
  • Ungraded: Pre-owned, vintage, unopened, may include a GTIN. Sold as a single item or still in its original box. For Ungraded collectibles, use closed list values specific to the product type.
  • Graded: Professionally graded and sealed by an approved grading company. May not include a GTIN. For Graded collectibles, grading_company and collectible_grade are conditionally required.

Grading Company

Refers to the third-party organization that evaluates and assigns a grade to the collectible. Approved grading companies include:

  • BCCG: Beckett Collector Club Grading
  • BGS: Beckett Grading Services
  • BVG: Beckett Vintage Grading
  • CGC: Certified Guaranty Company
  • PSA: Professional Sports Authenticator
  • SGC: Sportscard Guaranty Corporation

Collectible Grade

The specific rating given to the item, by a grading company, reflecting its quality.

  • Mint: Perfect, pristine condition.
  • Near Mint: Almost perfect, with very minor flaws.
  • Excellent, Very Good, Good, Fair, Poor: Each step down indicates increasing signs of wear or defects.

collectible_grade must match the grading value issued by the selected company.

Condition

A general description of the item’s physical state often used when a collectible is not professionally graded.

  • Like New: Nearly perfect, very minimal signs of handling.
  • Very Good: Minor signs of use, but well cared for.
  • Good: Noticeable wear, but item remains functional/displayable.
  • Acceptable: Significant wear or damage, but still collectible.
  • Damaged: Major defects, missing pieces, or heavy wear.

NOTE: Once you have submitted the collectible_grading_type and condition attributes on your collectible item, you cannot update these values. To update, you must create a new item.

Category-specific attributes

The Collectible attributes are added to support accurate listing of your items within select categories such as: Trading Cards, Trading Card Games, Autographed Collectibles, Collectibles Ephemera, Coins, Comics, and more.

NOTE: Currently, Trading Cards, Trading Card Games, and Coins are the only supported PTs for WFS.

Complete all required attributes to ensure items appear in the enhanced customer experience.

SFF schema sample with Collectible attributes and definition

{ "title": "MPItemFeed", "properties": { "MPItemFeedHeader": { "type": "object", "definition": "Contains attributes applicable to the entire submission. Only required one time for the item(s) being setup in the submission." }, "MPItem": { "minItems": 1, "definition": "This object is used to define each item being set up as part of the submission. This object must be completed for each unique item configuration being setup.", "type": "array", "items": { "type": "object", "title": "Visible", "properties": { "Collectible Ephemera": { "type": "object", "allOf": [ { "if": { "anyOf": [ { "properties": { "definition": "This section contains attribute requirements for exclusive product types such as collectibles. The Collectible Grading Type attribute is required. Additional attribute requirements depend on the value of Collectible Grading Type.", "collectible_grading_type": { "type": "string", "enum": ["Graded"] } }, "required": ["collectible_grading_type"] } ] }, "then": { "required": ["collectible_grade"] } }, { "if": { "anyOf": [ { "properties": { "collectible_grading_type": { "type": "string", "enum": ["New", "Ungraded"] } }, "required": ["collectible_grading_type"] } ] }, "then": { "required": ["condition"] } }, { "if": { "anyOf": [ { "properties": { "collectible_grading_type": { "type": "string", "enum": ["Graded"] } }, "required": ["collectible_grading_type"] } ] }, "then": { "required": ["grading_company"] } } ], "properties": { "collectible_grading_type": { "title": "Collectible Grading Type", "type": "string", "description": "Closed List - The Collectible Grading Type indicates if a Collectible has been professionally evaluated and graded.", "comments": "@group=Required for the item to be visible on Walmart website", "enum": ["New", "Graded", "Ungraded"] }, "collectible_grade": { "title": "Collectible Grade", "type": "string", "description": "Closed List - Standardized grade or rating assigned by a third-party service to evaluate and assess the a collectible's physical condition. Trading Cards & Trading Card Games: BCCG - Beckett Collector Club Grading: 5, 6, 7, 8, 9, 10 BGS - Beckett Grading Services: 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5, 5.5, 6, 6.5, 7, 7.5, 8, 8.5, 9, 9.5, 10 BVG - Beckett Vintage Grading: 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5, 5.5, 6, 6.5, 7, 7.5, 8, 8.5, 9, 9.5, 10 CGC - Certified Guaranty Company: 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5, 5.5, 6, 6.5, 7, 7.5, 8, 8.5, 9.0, 9.2, 9.4, 9.6, 9.8, 9.9, 10 PSA - Professional Sports Authenticator: AA, N0, 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5, 5.5, 6, 6.5, 7, 7.5, 8, 8.5, 9 ,10, Gem Mint 10 SGC - Sportscard Guaranty Corporation: 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5, 5.5, 6, 6.5, 7, 7.5, 8, 8.5, 9, 9.5, 10 GM, 10 PRI Comics: CBCS - Comic Book Certification Services: 0.1, 0.3, 0.5, 1.0, 1.5, 1.8, 2.0, 2.5, 3.0, 3.5, 4.0, 4.5, 5.0, 5.5, 6.0, 6.5, 7.0, 7.5, 8.0, 8.5, 9.0, 9.2, 9.4, 9.6, 9.8, 9.9, 10 CGC - Certified Guaranty Company: 0.5, 1.0, 1.5, 1.8, 2.0, 2.5, 3.0, 3.5, 4, 4.5, 5, 5.5, 6, 6.5, 7, 7.5, 8, 8.5, 9.0, 9.2, 9.4, 9.6, 9.8, 9.9, 10 Coins: CAC - Certified Acceptance Corporation : MS-70, MS-69, MS-68, MS-67, MS-66, MS-65, MS-64, MS-63, MS-62, MS-61, MS-60, PR-70, PR-69, PR-68, PR-67 , PR-66, PR-65, PR-64, PR-63, PR-62, PR-61, PR-60, AU-58, AU-55, AU-53, AU-50, XF-45, XF-40, VF-35, VF-30, VF-25, VF-20, F-15, F-12, VG-10, VG-8, G-6, G-4, AG-3, FR-2, PO-1 NGC - Numismatic Guaranty Company: MS-70, MS-69, MS-68, MS-67, MS-66, MS-65, MS-64, MS-63, MS-62, MS-61, MS-60, PF-70, PF-69, PF-68, PF-67 , PF-66, PF-65, PF-64, PF-63, PF-62, PF-61, PF-60, SP 70, SP 69, SP 68, SP 67, SP 66, SP 65, SP 64, SP 63, SP 62, SP 61, SP 60, AU-58, AU-55, AU-53, AU-50, XF-45, XF-40, VF-35, VF-30, VF-25, VF-20, F-15, F-12, VG-10, VG-8, G-6, G-4, AG-3, FR-2, PO-1 PCGS - Professional Coin Grading Service: MS-70, MS-69, MS-68, MS-67, MS-66, MS-65, MS-64, MS-63, MS-62, MS-61, MS-60, PR-70, PR-69, PR-68, PR-67 , PR-66, PR-65, PR-64, PR-63, PR-62, PR-61, PR-60, AU-58, AU-55, AU-53, AU-50, XF-45, XF-40, VF-35, VF-30, VF-25, VF-20, F-15, F-12, VG-10, VG-8, G-6, G-4, AG-3, FR-2, PO-1", "comments": "@group=Recommended to improve search and browse on Walmart website", "enum": [ "9.6", "9.8", "9.9", "10", "1", "2", "0.1", "3", "4", "0.3", "5" // ... (truncated for brevity)
}