---
title: "Interface: IObjectInspectorConfig | Customer's Canvas On-Premises"
canonical: "https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/WidgetConfigurationInterfaces.IObjectInspectorConfig/"
---

# Interface: IObjectInspectorConfig

> A structure containing the configuration of the Object inspector.

## Example

``` js
configuration = {
    widgets: {
        ObjectInspector: {
            bgItemEnabled: false,
            dndEnabled: false,
            toggleEnabled: true,
            inStringPlaceholderMode: "Single",
            violationWarningsEnabled: false
        }
    }
};
```

## Properties

### bgItemEnabled?

> `optional` **bgItemEnabled?**: `boolean`

Displays the background element in the Object inspector. The default value is `true`.

***

### dndEnabled?

> `optional` **dndEnabled?**: `boolean`

Allows your users to drag-and-drop layers in the Object inspector. The default value is `true`.

***

### violationWarningsEnabled?

> `optional` **violationWarningsEnabled?**: `boolean`

Enables preflight of user designs and displaying warnings in the Object inspector. The default value is `true`. For details, see [User interface overview](https://customerscanvas.com/dev/editors/iframe-api/editor-configuration/ui-overview.html).

***

### variableItemsEnabled?

> `optional` **variableItemsEnabled?**: `boolean`

Enables variable data printing for texts and images. If `true`, you can mark design elements as variable items in the editor and then customize them in your e-commerce system. The default value is `false`.

***

### emptyListTextEnabled?

> `optional` **emptyListTextEnabled?**: `boolean`

Enables the message displayed in the Object inspector when loaded template has no customizable layers.

***

### position?

> `optional` **position?**: [`ObjectInspectorPositionType`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/types/ConfigurationTypes.ObjectInspectorPosition.ObjectInspectorPositionType.md)

Defines where the Object Inspector shows - on the left or on the right side of the canvas. The default value is `Left`.

***

### aboveCanvasOnSmallScreenEnabled?

> `optional` **aboveCanvasOnSmallScreenEnabled?**: `boolean`

Allows you to show the Object Inspector above the canvas. If `true`, the Object Inspector appears above the canvas when you work on small-screen devices; otherwise, it appears from the left side of the canvas. The default value is `true`.

***

### isHidden?

> `optional` **isHidden?**: `boolean`

Allows for hiding the Object Inspector. The default value is `false`.

***

### toggleEnabled?

> `optional` **toggleEnabled?**: `boolean`

Enables the Toggle button, which allows your users to toggle the Object Inspector. The default value is `false`.

***

### inStringPlaceholderMode?

> `optional` **inStringPlaceholderMode?**: [`InStringPlaceholderModeType`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/enums/ConfigurationTypes.InStringPlaceholderMode.InStringPlaceholderModeType.md)

Defines how the Object Inspector displays in-string placeholders. In the `"Single"` mode, all items appear at the top of the item list. In the `"Multiple"` mode, linked in-string placeholders appear separately and keep the order defined in PSD templates. The default value is `"Multiple"`.

***

### showItemName?

> `optional` **showItemName?**: `boolean`

Enables text labels for design elements in the Object Inspector. The default value is `false`. For details, see the [Element Names](https://customerscanvas.com/dev/editors/iframe-api/editor-configuration/element-names.html) topic.

***

### groupRenameEnabled?

> `optional` **groupRenameEnabled?**: `boolean`

If `true`, the user can rename group names in the Object Inspector. The default value is `true`.

***

### groupsExpandedByDefault?

> `optional` **groupsExpandedByDefault?**: `boolean`

If `true`, automatically expands groups in the Object Inspector when loading a product. If `false`, groups of design elements appear collapsed. The default value is `false`.

***

### expandNestedGroups?

> `optional` **expandNestedGroups?**: `boolean`

If `true`, allows the user to expand all nested groups when clicking the parent group in the Object Inspector. If `false`, the user has to click the groups one by one to expand them all. The value in the config is `false`.