> For the complete documentation index, see [llms.txt](https://docs.rmhpos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rmhpos.com/store-manager/manage-items/matrix-items/setting-up-matrix-items.md). # Add matrix items {% hint style="info" %} It is recommended that you set up suppliers before you enter a large number of items. {% endhint %} 1. Click **Merchandising**. 2. Click **Items**. 3. To add a new item, click **New**. 4. Select **Matrix Item** and click **OK**. 5. On the **General** tab, enter information about the item.
FieldDescription
Matrix lookup code

A unique lookup code for the matrix item. The item lookup codes for component items are composed of the matrix lookup code, an optional separator character, and the attribute codes defined for each dimension.

Note: Matrix lookup codes can contain a maximum of 25 characters. You should ensure that the matrix lookup code, optional separator character, and attribute codes total 25 characters or less. Longer item lookup codes will be truncated.

DescriptionThe name or description of the matrix item.
Sub Description 1, 2, 3You can rename this field and use it to define additional attributes for the item, e.g., Size, Colour.
NotesAny notes that you want to enter about the matrix item.
DepartmentThe department the item belongs to.
CategoryThe category the item belongs to.
Item TaxThe tax that is applied to the item when it is sold.
Price

The price that is initially applied to all component items. Tip: ">

Tip: You can use the Advanced Item Wizard and Task 110: Change Item Prices to change the prices for specific component items after they are added to the store database. For example, if you are creating a matrix item for t-shirts, you might enter $15.99 as the initial price for all component items, but change the price of XXL t-shirts to $16.99 and the price of XXS t-shirts to $14.99.

CostThe amount the store paid to purchase the item.
SupplierThe primary supplier of the matrix item.
BarcodeThe item’s barcode type. For example, the UPC barcode type is the standard type of barcode for items sold to the general public. The barcode type affects how labels are formatted and printed.
6. On the **Component Item** tab, enter the dimensions and attributes for the component items: 1. For **Dimension 1**, enter a name for the dimension, e.g., SIZE. 2. For **Attributes**, enter the attributes of the dimension, e.g., EXTRA LARGE, LARGE, MEDIUM, SMALL, EXTRA SMALL. 3. For **Codes**, enter the codes for the attributes, e.g., XL, LG, MED, SM, XS. 4. (Optional) Repeat the previous three steps for **Dimension 2** and **Dimension 3**. {% hint style="success" %} To use a previously saved dimension, click the browse icon and select the dimension. If you select a previously saved dimension, the attributes and attribute codes from that dimension are automatically added. You cannot remove the attributes and attribute codes from the saved dimension, but you can add new attributes and attribute codes. {% endhint %}
7. On the **Component Item** tab, create the new component items: 1. Click **Create Components**. 2. Click **Yes** to create the component items based on the dimensions and attributes you entered. 3. Configure the **Item lookup codes** for the component items. The best practice is to use the suggested item lookup codes. 4. (Optional) Select **Use separator** end enter a character, such as a dash, that will be used to separate the attribute codes in the lookup codes. 5. Configure the **Item descriptions** for the component items. The best practice is to use the suggested item descriptions. 6. Click **OK**. A preview of the component items displays in the component items grid. {% hint style="warning" %} At this point, the matrix item and the component items have not been added to the store database. They are added when you click **Save And Close**. {% endhint %}
8. On the **Quantity View** tab, enter the on hand quantities of the component items.
9. Click **Save And Close**. The matrix item and the component items are added to the store database. {% hint style="success" %} If necessary, click **Refresh** to update the Items grid. {% endhint %}
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.rmhpos.com/store-manager/manage-items/matrix-items/setting-up-matrix-items.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.