Wanted List Match
Find the parts from your BrickLink Wanted List that are already in your own store inventory, pull them straight from stock, and update your Wanted List with what you filled.
Wanted List Match helps BrickLink sellers who also keep a Wanted List. When parts you want are already sitting in your own store inventory, this tool finds them, lets you pull them out of stock one lot at a time (your BrickLink inventory is updated for you), and then gives you a small update to paste back into BrickLink so your Wanted List knows what you filled.
Table of Contents
- Before You Start
- How to Use
- The Picking Checklist
- Conditions (New / Used / Any)
- Max Price
- Refreshing Your Inventory
- Finishing a Session
- Updating Your Wanted List
- Frequently Asked Questions
Before You Start
Requirements
- A connected BrickLink account. This tool reads and updates your live BrickLink store inventory.
- A Wanted List XML exported from BrickLink.
Exporting a Wanted List from BrickLink
- Open your Wanted List on BrickLink.
- Use the Download option to export it as an XML file.
How to Use
- Drag your Wanted List XML onto the upload area (or click to choose it) and click Match wanted list.
- We fetch your full BrickLink store inventory in the background — you can follow the progress — and then show which wanted parts you already have in stock.
- Work through the picking checklist: as you grab each lot from the warehouse, pull it. Each pull removes that quantity from your BrickLink inventory automatically.
- When you're done, click Finish session, then copy the generated update and paste it into BrickLink to record what you filled.
Only parts are matched. Sets, minifigures and other item types on your Wanted List are ignored. Parts are matched on part number, color and condition — and a part listed without a color is matched in every color you stock.
You can close the tab at any point — your progress is saved to your account, so you'll resume exactly where you left off, even on another device.
The Picking Checklist
The checklist is sorted by location — the remark you use on your BrickLink lots to note where they sit — so you can walk the warehouse in a single efficient loop. Each row shows the part, color, condition, location, available stock and your listing price, plus how many are wanted. Every row also links straight to that lot on BrickLink, so you can open it if you want to check something.
- Set the amount in the row's quantity field, then hit Pull to take it out of stock. Clicking twice by accident never subtracts twice.
- Pull everything handles every remaining row in one go, showing progress as it works. You can close the tab while it runs.
- Skip a row by leaving it at 0 (for example to keep a pricier part listed for sale). The price is shown so you can decide.
The summary bar at the top tracks how many of your wanted parts are in stock, how many pieces you are about to pull and what they are worth, and how many rows you have already checked off. Wanted parts you have no stock for are counted at the bottom of the list and need no action.
Right before each pull we check that lot's current quantity on BrickLink, so if you sold some elsewhere in the meantime, the pull is refused rather than taking stock you no longer have.
One Pull per Lot
Choose the amount before you pull. Each lot can be pulled once per session: as soon as the pull goes through, the row locks and shows Pulled. This is what makes a double-click or a page refresh safe, but it also means you cannot top up the same lot with a second pull later in the same session. If you need to take more from a lot you already pulled, finish the session and start a new one.
Parts Matched by Several Lots
When one wanted part matches two or more lots (say a used lot and a new one), those lots are grouped together under a header showing the part, how many are needed, how many you have assigned so far, and how many lots are available. A badge tells you at a glance whether the part is still partly unassigned, fully assigned, or already complete.
Each lot underneath spells out its own role: Pulling 2 from this lot, Not assigned, Above max price, Fully covered by another lot, or Pulled from this lot once it is done.
The quantity you want is shared across the whole group, not repeated per lot. Say you want 2 pieces and both are assigned to the cheapest lot: the other lot then stops at 0, because those 2 are already accounted for. Lower the first lot to 1 and the second immediately allows 1. This is what stops you from accidentally pulling 4 pieces for a part you only wanted 2 of.
By default the cheapest lots are filled first, so you sacrifice cheap stock and keep pricier listings for sale. Use Take from here instead on any lot to move the whole remaining need over to it in one click.
A part matched by only one lot stays a single, plain row — no grouping.
Parts Wanted in Any Color
A part on your Wanted List can be listed without a color, meaning you'll take it in whatever color you can get. Those wants are matched on the part number alone, so every color you have in stock shows up and you decide which ones to give away.
They use the same grouped layout as any other multi-lot part, with one difference: each lot underneath shows its own color, with a thumbnail of the part in that color, so you can tell them apart at a glance. The header says Any color instead of naming one, and tells you how many lots across how many colors are available.
Two things follow from that:
- Nothing is pre-filled. Every lot starts at 0, even the cheapest one. For a normal want the cheapest-first default only picks a lot; here it would be picking a color for you, which is exactly the choice the want leaves open. Use Take from here instead, or type a quantity, to choose.
- Because nothing is pre-filled, Pull everything skips these parts until you've assigned a color yourself.
The wanted quantity is still shared across the whole group, exactly as it is for lots of the same color: if you want 3 and take 2 from red, only 1 is left to take from blue.
When you export, all the colors you pulled are summed into the single colorless line your Wanted List holds — a want for 3 filled with 2 red and 1 blue records 3 filled on that one line. The update never adds color-specific lines to your list, which would leave you with new wants instead of a filled one.
A color of "(Not Applicable)" on your Wanted List is a real BrickLink color, not a missing one — it matches strictly like any other color.
If the Same Part Is Wanted Twice
You may have both a colorless want and a color-specific one for the same part — say "3626 in any color, 3 pieces" alongside "3626 in red, 1 piece". Both lines are shown, and the lot appears under each.
What you pull is only ever counted once. It is credited to the most specific line first — the red want fills before the colorless one — and anything above what that line still wants rolls over to the other. Pull 2 red and your list records 1 filled on the red want and 1 on the colorless want, never 2 on both. The same holds when a New want and an Any condition want overlap.
Conditions (New / Used / Any)
Each part on your Wanted List can ask for New, Used, or Any condition:
- New or Used only match lots of that same condition.
- Any matches both — your new and used lots appear as separate rows under one group header, and the total you can pull across them is still capped by the quantity you want. Cheaper lots are used first by default.
Condition and color are independent: a want for any condition in any color lists every new and used lot you have of that part, in every color.
Max Price
If a part on your Wanted List has a max price, any lot of yours priced above it is treated as too expensive to give away:
- The price is shown in red, with the ceiling underneath it.
- The lot is not filled in automatically, so Pull everything never touches it.
- When some parts have every lot over the ceiling, a checkbox appears above the table to hide them, keeping the picking list to what you actually intend to pull. A part you have already pulled from stays visible either way, so your work never disappears from the checklist.
Nothing is blocked. If you do want to pull an over-priced lot, just type the quantity into its field as usual.
A max price of 0 or -1 on your Wanted List means "no limit" — those are ignored, not treated as a ceiling of zero.
Refreshing Your Inventory
Your store inventory is fetched once when you upload the list. If you change your stock on BrickLink while a session is open, use Refresh inventory to fetch it again and rebuild the checklist. Everything you already pulled stays recorded.
Finishing a Session
Only one session can be active at a time. To start a new one, close the current session first:
- Finish session marks it complete and keeps the upload step available in your session history. Use this whenever you have pulled anything.
- Discard session throws it away. This is only offered before your first pull — once stock has actually left your inventory, finishing is the only way out, because a discarded session gives you no way to copy the update that records what you pulled.
Updating Your Wanted List
The final step is a copy-and-paste you do yourself. Click Copy wanted list XML and follow the on-screen steps to paste it on BrickLink's upload page. Nothing is downloaded as a file.
The XML lists only the parts you pulled, and for each one it records how many you filled from your own stock. BrickLink adds that to the Have quantity your Wanted List already holds, so the "still wanted" count drops by exactly the amount you took. Your wanted quantities stay as they were, and parts you didn't pull are left completely untouched.
That's why the import has to be additive rather than a replacement — it's a small update on top of your list, not a new version of it. The on-screen steps walk you through picking the right option on BrickLink.
You can come back to a finished session later from Previous sessions, open Copy & upload, and copy its XML again.
Frequently Asked Questions
Does this change my live BrickLink inventory?
Yes. Pulling a lot (or "Pull everything") lowers that lot's quantity on BrickLink, or removes the lot when it reaches zero. This is the one irreversible action, which is why your progress is tracked carefully.
What if I close the tab halfway through?
Come back any time. We keep a record of every pull, so the checklist comes back exactly as you left it and already-pulled parts stay marked as pulled.
Why can't I pull the same part from two lots?
You can — but only up to the number you actually want in total. That number is shared across every lot of the same part, so once one lot covers it, the others stop at 0. Lower the first lot to free up room for the second.
Why is a lot's quantity field stuck at 0?
Either the amount you want is already assigned to another lot of the same part — lower that one first — or you have pulled everything you wanted, so there is nothing left to take.
Why does a part start at 0 even though it's the cheapest lot?
That part is wanted in any color. Filling it automatically would mean choosing a color for you, so every lot starts at 0 until you assign one yourself. This is the only case where nothing is pre-filled.
I pulled two different colors for one want — will my Wanted List be right?
Yes. A colorless want is a single line on BrickLink, so everything you pulled for it is summed into that one line: 2 red plus 1 blue records 3 filled. No color-specific lines are added to your list.
Can I pull from the same lot twice in one session?
No. A lot can be pulled once per session, which is what makes an accidental double-click or a page refresh harmless. Decide the amount before you click Pull; to take more from that lot afterwards, finish the session and start a new one.
Why don't I see a part that's on my Wanted List?
Four reasons are normal: it isn't a part (sets and minifigures are skipped), it has no wanted quantity set, its Have quantity on BrickLink already covers what you wanted, so there is nothing left to pick, or you have the price filter ticked and every lot of it is above your max price.
A part with no quantity — a missing, 0 or negative wanted quantity on your list — is left out entirely rather than treated as a want for 1. It asks for nothing, so there is nothing to pick and nothing is ever pulled for it.
Some pieces were already filled on my Wanted List — does that count?
Yes. We only ever pull what is still wanted: the quantity you asked for minus the Have quantity already on your list. That pre-existing amount is also left out of the export, so an additive import can't double-count it.
Why can't I discard my session?
Because you have already pulled parts from it. Those pieces really left your inventory, so the session has to be finished instead — that keeps the upload step available so you can still record the pulls on your wanted list.
Why import additively instead of replacing my wanted list?
Because the file only contains the parts you just pulled — it is an update, not a full copy of your list. Choosing the additive option keeps everything else in your Wanted List exactly as it was and simply records what you filled. Replacing would wipe out every part that isn't in this file.