> For the complete documentation index, see [llms.txt](https://docs.candy-smith.com/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.candy-smith.com/main/match-3-kit-home-design/customization/add-new-item.md).

# Add new Item

### Open the Level Editor

In the Unity Editor, open:

HomeDesignMatch3Kit > Editors > Level Editor

<figure><img src="/files/IXk7MC3nxasG5oa6N97G" alt=""><figcaption></figcaption></figure>

### Create the Item

1. Select the Items tab.
2. Click the + button at the end of the item palette.
3. Enter a unique name in the Name field.
4. Select a compatible prefab in the Template field.
5. Select the item kind.
6. Configure the item options.
7. Click Create.

<figure><img src="/files/OdI7Fjfss3yWB7lJ4rLG" alt="" width="375"><figcaption></figcaption></figure>

The editor copies the selected template, applies the selected options, saves a new prefab, refreshes the asset database, and adds the item to the item palette.

### Item Options

#### Item Kind

Select one of the following item kinds:

* Colored — creates a regular colored match-3 item;
* CombinationBonus — creates an item that is generated by a board combination.

The template list is automatically filtered according to the selected item kind.

### Colored Items

Select Colored as the item kind.

#### Color

Use the Color field to assign the color index of the item.

Colored items use an ItemColored prefab template and are saved to:

Assets/HomeDesignMatch3Kit/Resources/Items/\_ColoredItems/.prefab

### Combination Bonuses

Select CombinationBonus as the item kind.

#### Bonus Type

Use the Bonus type field to select the ItemsTypes value of the bonus.

The selected template must contain a compatible ItemBonus implementation.

To setup bonus follow this page [Bonus item setup](/main/match-3-kit-home-design/customization/bonus-item-setup.md)

#### Size in Squares

Use Size in squares to define how many board cells the bonus occupies.

The bonus prefab is saved to:

Assets/HomeDesignMatch3Kit/Resources/Items/Bonuses/.prefab

The editor also creates a combination asset at:

Assets/HomeDesignMatch3Kit/Resources/Settings/Combinations/.asset

The new combination asset is initialized and opened automatically in the Combination Editor.

Configure the combination matrix by selecting the cells that participate in the combination. The combination asset's item type must match the item's currentType.

### Where the Prefab Is Saved

Colored items are saved to:

Assets/HomeDesignMatch3Kit/Resources/Items/\_ColoredItems/

Combination bonuses are saved to:

Assets/HomeDesignMatch3Kit/Resources/Items/Bonuses/

### Use the New Item in a Level

1. Select the new item in the Items palette.
2. Click cells in the level grid to place the item.
3. Save the level asset.

Right-click an item in the palette to select and highlight its prefab in the Project window.

### Function Limitations

The editor copies the template's components, sprites, colliders, animations, and item behaviours.

It does not create:

* new gameplay scripts;
* new sprites;
* new animations;
* new collider setups;
* custom item behaviour.

For an item with new gameplay rules, create the required component first and use a prefab that already contains the required base setup as the template.