---
title: "Defining Names of Design Elements"
canonical: https://customerscanvas.com/docs/cc6/defining-item-names.htm
archived: true
applies_to:
  - product: "Customer's Canvas On-Premises"
  - product: "Design Editor"
    versions: ["6.15.0", "6.x (may differ)"]
---

**You’re viewing outdated documentation.** [View the latest Customer’s Canvas On-Premises documentation](https://customerscanvas.com/docs/on-premises/).

# Defining Names of Design Elements

**Applies to:** Customer's Canvas On-Premises; Design Editor 6.15.0, 6.x (may differ) · **Archived documentation**
 
Customer's Canvas allows you to specify a name for every design element being added to the canvas.
 
You can use these names to modify design elements through the [IFrame API](https://customerscanvas.com/docs/cc6/introduction-to-iframe-api-v5.htm.md) as well as post-process products created in the Design Editor, for example, to personalize them through the [Web API](https://customerscanvas.com/docs/cc6/web-api-for-rendering.htm.md). You can also display these names on the canvas and in the **Object Inspector** to improve the user experience.
 
There are two ways to define item names in the editor:
 
- Predefine a name when configuring design elements.
- Enable a dialog box to allow your users to type in unique names when editing products.

You can use the former method when you know in advance what elements should be added to the product. The latter method does not limit the number of unique names and requires your users to specify item names. In both cases, you need to configure the [Toolbox](https://customerscanvas.com/docs/cc6/customizing-toolbox.htm.md).
 
For more details about configuring design elements, refer to the [Custom Design Elements](https://customerscanvas.com/docs/cc6/custom-design-elements.htm.md) topic. Now, let us see how to configure a dialog box to name items.
 
## Creating New Items
  
When the user clicks a button in the **Toolbox** to create a new design item, the following dialog box appears to specify the name of this item.
 
![Defining an item name in the dialog box.](https://customerscanvas.com/docs/cc6/images/DefiningItemNames.png)
 
To enable this dialog box for a single button, set the **nameDialogEnabled** property to `true` in `clientConfig.json` as follows:
 
```
{
    "widgets": {
        "Toolbox": {
            "buttons": [
                {
                    "translationKey": "Toolbox.ADD_TEXT",
                    "translationKeyTitle": "Toolbox.TITLE_ADD_TEXT",
                    "nameDialogEnabled": true,
                    "iconClass": "cc-icon-add-text",
                    "action": "Text"
                },
                {
                    "translationKey": "Toolbox.IMAGE",
                    "translationKeyTitle": "Toolbox.TITLE_ADD_IMAGE",
                    "nameDialogEnabled": true,
                    "iconClass": "cc-icon-add-image",
                    "action": "Image"
                }
            ]
        }
    }
}
```
 
## Displaying the Item Names
  
By default, the Design Editor does not display names of design items. However, you can enable these names both on the canvas and in the **Object Inspector**.
 
On the canvas, text labels appear above the rectangle bounding the design element when the user hovers the mouse over it.
 
![Displaying item names on the canvas.](https://customerscanvas.com/docs/cc6/images/DefiningItemNamesCanvas.png)
 
To enable these labels, set the **canvas.canvasItemHoverEnabled** property to `true` in `clientConfig.json`.
 
```
{
    "canvas": {
        "canvasItemHoverEnabled": true
    }
    ...
}
```
 
In the **Object Inspector**, these names appear as layer names.
 
![Displaying item names in the Object Inspector.](https://customerscanvas.com/docs/cc6/images/DefiningItemNamesOI.png)
 
To enable these labels, set the **widgets.ObjectInspector.showItemName** property to `true`.
 
```
{
    "widgets": {
        "ObjectInspector": {
            "showItemName": true
        }
        ...
    }
}
```
 
## Changing the Item Names
  
You can also change item names through the **Item Menu**. By default, the **Rename** command is disabled in the menu but you can enable it as follows:
 
```
{
    "widgets": {
        "ItemMenu": {
            "renameEnabled": true
        }
        ...
    }
}
```
 
This configuration allows you to rename items by right-clicking them on the canvas as well as clicking the **More** button in the **Object Inspector**.
 
To disallow your users from renaming group names in the **Object Inspector**, you can set the **widgets.ObjectInspector.groupRenameEnabled** property to `false`.
 
## See Also
  
### Manual
 
- [Customizing the Toolbox](https://customerscanvas.com/docs/cc6/customizing-toolbox.htm.md)
- [Custom Design Elements](https://customerscanvas.com/docs/cc6/custom-design-elements.htm.md)
- [Using the Design Atoms Framework in IFrame API](https://customerscanvas.com/docs/cc6/introduction-to-iframe-api-v5.htm.md)
- [Web API for Personalized Rendering](https://customerscanvas.com/docs/cc6/web-api-for-rendering.htm.md)