---
title: "IPlaceholderItemDefaultConfig Interface"
canonical: https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iplaceholderitemdefaultconfig.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/).

# IPlaceholderItemDefaultConfig Interface

**Applies to:** Customer's Canvas On-Premises; Design Editor 6.15.0, 6.x (may differ) · **Archived documentation**
 
A structure defining the default parameters of image placeholders. These parameters apply to those image placeholders that the user adds to the canvas.
  
You can apply these parameters to the **placeholder** object through either `clientConfig.json` or [IConfiguration](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.iconfiguration.htm.md). The following example shows how you can allow your users to select images only from the `europe_photos` subfolder of the public folder and disable the cover mode.
 
 - example
     - ```
{
    "defaultItemsConfig": {
        "placeholder": {
            "allowedSubfolder": "europe_photos",
            "isCoverMode": false
        }
    }
}
```
 
## Properties
 
### Optional allowedSubfolder
 
allowedSubfolder: string

Defines a subfolder of `\assets\images\` from which the user can select images for placeholders. When you specify this property, the gallery shows images only from the corresponding public subfolder. By default, your users can select images from any gallery tab or public subfolder.
 
### Optional allowedTabs
 
allowedTabs: string []

Defines an array of gallery tab names from which the user can select images for placeholders. For example, to open only the **Public files** and **My files** tabs for image placeholders, set **allowedTabs** to `["Public files", "My files"]`. By default, your users can select images from any gallery tab.
 
### Optional angle
 
angle: number

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[angle](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md)

An angle, which design elements are rotated to. By default, this value is `0`.
 
### Optional barcodeContent
 
barcodeContent: [BarcodeContentType](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.htm.md)

Defines the barcode content type.
 
### Optional barcodeFormat
 
barcodeFormat: [BarcodeFormat](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.editor.barcodeformat.htm.md)

Defines the barcode format.
 
### Optional blendMode
 
blendMode: [BlendMode](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.blendmode.htm.md)

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[blendMode](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md)

A blend mode that applies to design elements being added to the canvas.
 
### Optional borderColor
 
borderColor: string

Inherited from [IShapeItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.ishapeitemdefaultconfig.htm.md).[borderColor](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.ishapeitemdefaultconfig.htm.md)

The border color. The default value is `"rgba(0,0,0,1)"`.
 
### Optional borderWidth
 
borderWidth: number

Inherited from [IShapeItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.ishapeitemdefaultconfig.htm.md).[borderWidth](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.ishapeitemdefaultconfig.htm.md)

The border width, in points. The default value is `1`.
 
### Optional contentBarcodeColor
 
contentBarcodeColor: string

Defines the barcode color. The default value is `"rgb(0, 0, 0)"`.
 
### Optional contentImageUrl
 
contentImageUrl: string

Defines a link to an image used as the placeholder's content. You can define URLs, links to private images (`"user:someprivateimage.png"`), and images from the public gallery (`"public:logos/logo.png"`).
 
### Optional contentPermissions
 
contentPermissions: [IContentPermissionsConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.icontentpermissionsconfig.htm.md)

Defines permissions for the content of placeholders.
 
### Optional contentResizeMode
 
contentResizeMode: [ContentResizeMode](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.htm.md)

Defines the resize mode for image placeholders. It can be either `fill`, `fit`, or `original`. For details, refer to the [Image Placeholders](https://customerscanvas.com/docs/cc6/image-placeholder.htm.md) topic. The default value is `fill`.
 
### Optional fillColor
 
fillColor: string

Inherited from [IShapeItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.ishapeitemdefaultconfig.htm.md).[fillColor](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.ishapeitemdefaultconfig.htm.md)

The fill color for shapes and placeholders. The default value is `"rgba(112,112,112,1)"` for shapes and is `"rgba(0,0,0,0)"` for image placeholders.
 
### Optional fixedStubContentSize
 
fixedStubContentSize: boolean

Maintains the size of stub images while resizing image placeholders. The default value is `false`.
 
### Optional height
 
height: string  |  number

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[height](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md)

The height of design elements being added to the canvas, in points or percent. For QR codes, the [width](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iplaceholderitemdefaultconfig.htm.md) value is used for both **width** and **height**.
 
### Optional isCoverMode
 
isCoverMode: boolean

Enables the cover mode for image placeholders. The default value is `true`.
 
### Optional isStubContent
 
isStubContent: boolean

Defines whether this is a stub placeholder. The default value is `false`.
 
### Optional isVariable
 
isVariable: boolean

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[isVariable](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md)

Marks a design element as a variable item. The default value is `false`.
 
### Optional itemPermissions
 
itemPermissions: [IItemPermissionsConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitempermissionsconfig.htm.md)

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[itemPermissions](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md)

A structure defining the Item Menu and the Floating item toolbar for design elements.
 
### Optional location
 
location: [ILocationDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.ilocationdefaultconfig.htm.md)

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[location](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md)

The coordinates of design elements being added to the canvas. By default, you can add them to the center of your product.
 
### Optional manipulationPermissions
 
manipulationPermissions: [IManipulationPermissionsConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.imanipulationpermissionsconfig.htm.md)

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[manipulationPermissions](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md)

A structure defining the manipulation permissions for design elements.
 
### Optional name
 
name: string

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[name](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md)

The name of design elements being added to the canvas.
 
### Optional opacity
 
opacity: number

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[opacity](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md)

An opacity that applies to design elements. This value can be from `0` to `1`. By default, it is `1`.
 
### Optional placeholderPermissions
 
placeholderPermissions: [IPlaceholderPermissionsConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iplaceholderpermissionsconfig.htm.md)

Defines permissions for placeholders.
 
### Optional shapePermissions
 
shapePermissions: [IShapePermissionsConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.ishapepermissionsconfig.htm.md)

Inherited from [IShapeItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.ishapeitemdefaultconfig.htm.md).[shapePermissions](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.ishapeitemdefaultconfig.htm.md)

Defines permissions for shapes.
 
### Optional textWrappingMode
 
textWrappingMode: [WrappingModeType](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.wrappingmode.htm.md)

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[textWrappingMode](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md)

A wrapping mode that applies to wrap text around design elements. By default, it is `"none"`.
 
### Optional themeBinding
 
themeBinding: [IThemeBindingConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.ithemebindingconfig.htm.md)

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[themeBinding](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md)

A style or a color that applies to new design elements.
 
### Optional visualizationPermissions
 
visualizationPermissions: [IVisualizationPermissionsConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.ivisualizationpermissionsconfig.htm.md)

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[visualizationPermissions](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md)

A structure defining the visualization permissions for design elements.
 
### Optional width
 
width: string  |  number

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[width](https://customerscanvas.com/docs/cc6/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md)

The width of design elements being added to the canvas, in points or percent.