> ## Documentation Index
> Fetch the complete documentation index at: https://developer.voyado.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Article XML import

The article XML importer allows you to import an article directory from a file.

The following fields are available in the \<article> node of your XML import file.

| Field              | Format  | Max. characters | Description                                                                                                                 |
| ------------------ | ------- | --------------- | --------------------------------------------------------------------------------------------------------------------------- |
| sku\*              | string  | 255             | Article SKU, the most detailed designator for an article. This must be unique. Transactions will be matched using this key. |
| number\*           | string  | 255             | Article number / group number, can be shared by color variants of the same product over multiple SKUs                       |
| name\*             | string  | 255             | The article name in human readable form.                                                                                    |
| maincategory\*     | string  | 255             |                                                                                                                             |
| awardsbonus        | boolean | 1 or 0          | If 1 (true) this article can award points, otherwise it does not                                                            |
| brand              | string  | 255             |                                                                                                                             |
| color              | string  | 255             |                                                                                                                             |
| size               | string  | 100             |                                                                                                                             |
| productcategory    | string  | 255             |                                                                                                                             |
| subcategory        | string  | 255             |                                                                                                                             |
| agegroup           | string  | 255             |                                                                                                                             |
| gender             | string  | 6               |                                                                                                                             |
| description        | string  | 255             |                                                                                                                             |
| season             | string  | 255             |                                                                                                                             |
| gtin               | string  | 20              | Global trade item number, same as EAN but a more international standard                                                     |
| spare1 ... spare10 | string  | 255             | Ten fields (named "spare1" up to "spare10") for additional data                                                             |

*\* indicates a mandatory field.*

You can find examples [on the example files page](/docs/file-based-transfer/example-files).

<Tip>
  If you are using Elevate, make sure that the variant ID in Elevate matches the SKU in Engage.
</Tip>