Walmart

The Walmart integration lets you create and manage Walmart Marketplace listings from YuCommerce. Items are submitted via Walmart’s Feed API, and status updates are polled automatically.

Connecting Your Account

1. Go to Settings → Walmart
2. Enter your Client ID and Client Secret (generated from Walmart Seller Center)
3. YuCommerce validates the credentials by exchanging them for an access token
4. On success, your account is marked as Connected

If credentials are later revoked, an error state appears prompting you to re-enter.

Setting Up a Product

1. Navigate to a product’s edit page
2. Click the Walmart marketplace card
3. On the setup page, search the Walmart taxonomy and select a product type
4. YuCommerce automatically derives variant grouping from your product’s variation types
5. Click Initialize to create draft listings

Each child listing’s title is automatically set to the product title followed by its variation values — for example, “Cotton T-Shirt - Red, Large”.

If a SKU is already on Walmart

During setup, YuCommerce checks each of your SKUs against your Walmart account. If a SKU already exists there, its listing is created already linked to the live Walmart item and shows that item’s status (Active, Unpublished, and so on) — you don’t have to re-create it. YuCommerce matches the SKU and reflects its status, but it does not pull the item’s existing attributes back from Walmart. The first time you open such a listing, its form is pre-filled from your YuCommerce product data so you have a starting point to review before submitting any changes.

Keeping Listings in Sync

Once a product is set up on Walmart, its listings track your product’s SKUs automatically:

• New SKUs (for example, after you add a variation value to a published product) appear as draft listings the next time you open the Walmart listings page. Fill in their details and submit when ready. New SKUs do not create listings on their own — open the listings page to pick them up.
• Removed SKUs — when you delete a variation value (removing its SKUs) or delete the product, the matching Walmart listings are removed from YuCommerce right away.

If a listing was already live on Walmart when its SKU was removed, it is no longer tracked in YuCommerce but may remain live on Walmart — retire it in Seller Center if needed.

Listing Lifecycle

Status	Meaning
Draft	Not yet submitted — edit attributes freely
Pending	Feed sent to Walmart, still processing
Active	Walmart accepted the listing — it’s live
Error	Walmart rejected the listing — check Seller Center for details
Unpublished	Was live, now removed from sale on Walmart
Retired	Permanently removed from Walmart

Editing Listings

The listings page uses the same two-column layout as Amazon:

• Left: Side navigation with all listings and status badges
• Right: Dynamic form generated from Walmart’s product type schema

Submitting

Walmart uses a feed-based submission model. When you submit, all dirty listings are batched into a single feed and sent to Walmart. Feed status is polled automatically.

How It Differs from Amazon

Aspect	Amazon	Walmart
Submission	Direct per-item PUT	Feed-based batch
Parent listing	Real entity submitted to Amazon	Shell for grouping (not submitted)
Variant model	Parent-child hierarchy	Peer group
Auth	OAuth redirect flow	Client ID + Secret paste-and-validate
Existing listings	Imports the item’s attributes from Amazon	Matches the SKU and reflects its status only — attributes are not pulled back

Limitations

• Walmart US only in this version
• Feed processing is asynchronous — status updates happen on the next poll cycle
• Schema fetching is throttled to 3 concurrent requests per seller — schemas are cached for 24 hours, so this is rarely noticeable
• Orders management is not yet supported
• Inventory and price sync to Walmart is not yet supported — update quantity and price by editing the listing and re-submitting
• Import of existing Walmart listings imports SKU matching only (not full attributes)