The three stock modes
“Shared stock” and “shared quantity” mean the same thing in Xlistr. The app label is Shared quantity.
Which mode should I use?
If you are unsure, start with Single unit. It is the safest mode for second-hand stock. You can change the mode later if the item turns out to have variants.Single unit
- The item can only be sold once.
- When it sells, Xlistr can delist the other marketplace listings.
- The quantity should stay at 1.
- If you own two identical items, create two inventory items or use a quantity of 2 with shared quantity.
Variants
Variants are for items that are genuinely different:- sizes S, M, L, XL;
- colours navy, olive, rust;
- shoe sizes 7, 8, 9.
Shared quantity
Shared quantity lets several marketplace listings draw from the same physical stock. Example: you own one jacket. You list it on eBay, Vinted and Depop. All three listings point to the same inventory item with a quantity of 1. When it sells on Vinted, the quantity drops to 0 and Xlistr can end the eBay and Depop listings. This is the core crosslisting model. It is what stops you from selling the same jacket twice.Listing priority
When stock is limited, listing priority helps Xlistr decide which marketplace should keep the item available first. Think of it as a queue:- The marketplace with the highest priority gets the stock first.
- When the stock runs low, lower-priority listings may be paused or ended.
- The exact behaviour depends on the marketplace and your settings.
Minimum stock threshold
A minimum stock threshold is an eligibility cutoff. It is not a number subtracted from your stock. Example: if the threshold is 1 and the quantity drops to 0, the listing is no longer eligible to stay available. Xlistr can then pause or end it. Do not confuse it with “keep one back for myself”. If you want to keep a buffer, use a higher threshold and check the resulting listing statuses.After a stock change
- Open the inventory item.
- Check the quantity.
- Look at the linked marketplace listings.
- Check the publish status and sync status.
- If an update is waiting, check the connection.
- If an update failed, read the exact message before retrying.
Common problems
I sold one item but the other listings are still live
I sold one item but the other listings are still live
Check the marketplace connections first. Auto-delist needs a healthy connection. If the connection is waiting, the other listings may still be live. Delist them manually if you need to stop a double sale immediately.
The quantity is wrong on one marketplace
The quantity is wrong on one marketplace
Open the item, check the inventory quantity, then check the listing’s target quantity. If they differ, refresh the listing or update the quantity. Read the sync status before retrying.
I have two identical items
I have two identical items
Use Shared quantity with a quantity of 2, or create two separate inventory items if you want to track them individually. Do not use Single unit for both unless you really have two separate records.
A variant sold out but the parent item still looks available
A variant sold out but the parent item still looks available
Check the variant quantity, not just the parent item. The parent may show the total while the specific variant is at zero.
The minimum threshold is blocking a listing
The minimum threshold is blocking a listing
Lower the threshold if you want the listing to stay available at a lower quantity. Raise it if you want to stop earlier. Check the resulting statuses after the change.
Next steps
Inventory-first basics
Understand the inventory item and its linked listings.
Inventory hub
Find the item and check its marketplace tiles.
Auto-delist, restock and refresh
Learn what happens after a sale and how to replenish stock.
Background actions
Understand queued, waiting, failed and completed.