Help Center: Wanted List

Wanted List, Mass Upload
⚠ PAGE UNDER CONSTRUCTION - SOME INFORMATION MAY BE INCORRECT, INCOMPLETE, OR OUT OF ORDER ⚠


A wanted list for items in the BrickLink catalog can either be uploaded from a third party software file or be uploaded in BrickLink XML format on the Upload to Wanted List page.

To upload a third party software file, ensure that Upload a file from your computer is selected. The supported third party software file types are BrickStock/BrickStore files (.bsx), LDraw files (.ldr), LEGO Digital Designer files (.lxf), and Studio files (.io). The maximum file size allowed for upload is 204800 bytes.

To upload in BrickLink XML format, ensure that Upload BrickLink XML format is selected. Below are the guidelines for how to create a wanted list in BrickLink XML format along with detailed explanations of the available elements that must or can be used. A sample wanted list in BrickLink XML format follows that.


Creating a Wanted List in BrickLink XML format

  • A wanted list in BrickLink XML format can not have an XML declaration. For example, any line similar to
    <?xml version="1.0" encoding="UTF-8">
    must be removed.

  • A wanted list in BrickLink XML format must open with an
    <INVENTORY>
    tag and close with a corresponding
    </INVENTORY>
    tag. This is known as the
    INVENTORY
    element.

  • An item being listed in a wanted list in BrickLink XML format must open with an
    <ITEM>
    tag and close with a corresponding
    </ITEM>
    tag. This is known as an
    ITEM
    element. One or more
    ITEM
    elements must be placed inside the
    INVENTORY
    element (i.e. between the
    <INVENTORY>
    and
    </INVENTORY>
    tags).

  • An item being listed in a wanted list in BrickLink XML format must contain two required elements and can contain other optional elements. Whether required or optional, these elements must all be placed inside an
    ITEM
    element (i.e. between the
    <ITEM>
    and
    </ITEM>
    tags for a given item). Omitting one or more of the required elements will result in an error during the upload process. The following table summarizes the elements available for use inside an
    ITEM
    element.

    Element Usage Required Details
    ITEMTYPE <ITEMTYPE>
    value
    </ITEMTYPE>     		Yes value must be one of the following: S (for a set), P (for a part), M (for a minifigure), B (for a book), G (for a gear item), C (for a catalog), I (for an instruction manual), or O (for an original box)
    ITEMID <ITEMID>
    value
    </ITEMID>     		Yes value is the Item No. for this item in the BrickLink catalog
    COLOR <COLOR>
    value
    </COLOR>     		No This element is only needed when this item is a part or a gear item that is wanted in a specific color.

    value is a color ID from the Color Guide
    MAXPRICE <MAXPRICE>
    value
    </MAXPRICE>     		No This element is only needed when this item is wanted for less than or equal to a specific maximum price.

    value is a number greater than 0
    MINQTY <MINQTY>
    value
    </MINQTY>     		No This element is only needed when a specific minimum quantity of this item is wanted.

    value is a whole number greater than 0
    QTYFILLED <QTYFILLED>
    value
    </QTYFILLED>     		No Quantity Filled
    This is the quantity of the item that you already have. Filling in this section will allow you to make progress toward completing a wanted list.
    CONDITION <CONDITION>
    value
    </CONDITION>     		No This element is only needed when this item is wanted in a specific condition. Refer to the Item For Sale Condition help page for further information about item conditions.

    value must be one of the following: N (for new) or U (for used)
    REMARKS <REMARKS>
    value
    </REMARKS>     		No This element is only needed when any additional comments about this item are necessary. These comments are only visible privately.

    value is any text

    Note: value can not directly contain HTML tags (e.g. <b></b>) or stand-alone ampersands (&). Instead, the following HTML character entities must be used: < in place of a less than sign, > in place of a greater than sign, and & in place of an ampersand.
    NOTIFY <NOTIFY>
    Y
    </NOTIFY>     		No This element is only needed when a notification by email is wanted for any new lots of this item that are listed for sale.
    WANTEDSHOW <WANTEDSHOW>
    Y
    </WANTEDSHOW>     		No Show in Items For Sale Queries
    Leave blank or enter Y for this item to be included in item for sale queries or enter N for this item to not be included in item for sale queries.
    WANTEDLISTID <WANTEDLISTID>
    value
    </WANTEDLISTID>     		No ID of my Additional Wanted List (Field Explanation)
    Omitting this tag will upload the item to your main wanted list. Enter the ID of your wanted list you wish to upload this item to.


Sample Wanted List in BrickLink XML format

<INVENTORY>
<ITEM>
<ITEMTYPE>
P
</ITEMTYPE>

<ITEMID>
3622
</ITEMID>

<COLOR>
11
</COLOR>

<QTYFILLED>
4
</QTYFILLED>

</ITEM>
<ITEM>
<ITEMTYPE>
P
</ITEMTYPE>

<ITEMID>
3039
</ITEMID>

</ITEM>
<ITEM>
<ITEMTYPE>
P
</ITEMTYPE>

<ITEMID>
3001
</ITEMID>

<COLOR>
5
</COLOR>

<MAXPRICE>
1.00
</MAXPRICE>

<MINQTY>
100
</MINQTY>

<CONDITION>
N
</CONDITION>

<REMARKS>
for MOC AB154A
</REMARKS>

<NOTIFY>
N</NOTIFY>
</ITEM>
</INVENTORY>


Additional Notes

If an item is already on your wanted list then the following will happen: If wanted qty is not entered then the item will be excluded from upload. If wanted qty is entered and existing wanted qty is N/A then the wanted qty on the existing item will be changed to the new wanted qty. If wanted qty is entered and existing wanted qty is not N/A then the wanted qty of the item in the upload will be added to the qty of the existing item.

  • If the upload errors out in the middle, the whole file is rolled back and your wanted list is returned to how it was before the file was uploaded.
View a translated version of this help topic in:
Česky | Deutsch | Español | Français | Português
This document was last updated on Feb 14, 2024 18:03 by CE_Eric