An inventory for an item in the BrickLink catalog can be uploaded in BrickLink XML format on the Add Inventory page. If there is an error in the BrickLink XML format, the upload process will stop and display an error message. Once the BrickLink XML format has been successfully uploaded with no errors, the inventory can be verified before being submitted to an Inventories Administrator for final approval.

Below are the guidelines for how to create an inventory in BrickLink XML format along with detailed explanations of the available elements that must or can be used. A sample inventory in BrickLink XML format follows that.

Creating an Inventory in BrickLink XML format

An inventory 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.
An inventory in BrickLink XML format must open with an
tag and close with a corresponding
tag. This is known as the
INVENTORY
element.
An item being listed in an inventory in BrickLink XML format must open with an
tag and close with a corresponding
tag. This is known as an
ITEM
element. One or more
ITEM
elements must be placed inside the
INVENTORY
element (i.e. between the
and
tags).

An item being listed in an inventory in BrickLink XML format must contain four 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

and

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	value	Yes	value must be one of the following: S (for a set), P (for a part), M (for a minifigure), B (for a book), or G (for a gear item) Note: A minifigure inventory can only contain parts.
ITEMID	value	Yes	value is the Item No. for this item in the BrickLink catalog
COLOR	value	Yes	value is a color ID from the Color Guide Note: If this item is a set, a minifigure, or a book, value must be 0.
QTY	value	Yes	value is a whole number greater than 0 representing the quantity of this item in the inventory
EXTRA	Y	No	This element is only needed when this item is an extra item in the inventory. Refer to the Inventory Sections help page to determine if this item is considered an extra item for the purposes of the inventory. Note: A minifigure inventory can not contain extra items.
COUNTERPART	Y	No	This element is only needed when this item is a counterpart in the inventory. Refer to the Inventory Sections help page to determine if this item is considered a counterpart for the purposes of the inventory. Note: A minifigure inventory can not contain counterparts.
ALTERNATE	Y	No	This element is only needed when this item is an alternate item in the inventory. Refer to the Inventory Sections help page to determine if this item is considered an alternate item for the purposes of the inventory. Note: A minifigure inventory can not contain alternate items.
MATCHID	value	No	This element is only needed to create a match between one or more alternate items with one or more regular items. Regular items are those that are not extra items, counterparts, or alternate items. value is a whole number greater than 0 representing the match ID for a group of items that are matched together in the inventory. value should start at 1 for the first group of items that are matched together and then be incremented by 1 for each additional group of items that are matched together. value must be the same for all items in the same group. Note: All items with a match ID must be sorted at the bottom of the inventory.

Sample Inventory in BrickLink XML format

The sample inventory in BrickLink XML format shown here contains the parts which make up the Skeleton with Standard Skull minifigure.

6260

3626bpb0001

6265

6266

Adding an Inventory, XML Upload

Creating an Inventory in BrickLink XML format

Sample Inventory in BrickLink XML format