---
title: "IPlaceholderItemDefaultConfig Interface"
canonical: https://customerscanvas.com/docs/cc4/customerscanvas.iframeapi.configuration.defaultconfig.iplaceholderitemdefaultconfig.htm
archived: true
applies_to:
  - product: "Customer's Canvas On-Premises"
  - product: "Design Editor"
    versions: ["4.4.25", "4.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 4.4.25, 4.x (may differ) · **Archived documentation**
 
A structure defining the default parameters of image placeholders.
  
You can apply these parameters to the **placeholder** object through either `clientConfig.json` or [IConfiguration](https://customerscanvas.com/docs/cc4/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": {
            "allowedPublicSubfolder": "europe_photos",
            "isCoverMode": false
        }
    }
}
```
 
## Properties
 
### Optional allowedSubfolder
 
allowedSubfolder: string

Defines a subfolder of `PublicGalleryFolder` from which the user can select images for placeholders. When you specify this property, the gallery shows images only from the corresponding public subfolder, and no other tabs are available. 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** and **My files** tabs for image placeholders, set **allowedTabs** to `["Public", "User"]`. By default, your users can select images from any gallery tab.
 
### Optional angle
 
angle: number

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc4/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[angle](https://customerscanvas.com/docs/cc4/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/cc4/customerscanvas.iframeapi.configuration.defaultconfig.htm.md)

Defines the barcode content type.
 
### Optional borderColor
 
borderColor: string

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

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

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

The border width, in points. The default value is `1`.
 
### 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: [IContentPermisssionsConfig](https://customerscanvas.com/docs/cc4/customerscanvas.iframeapi.configuration.defaultconfig.icontentpermisssionsconfig.htm.md)

Defines permissions for the content of placeholders.
 
### Optional contentResizeMode
 
contentResizeMode: [ContentResizeMode](https://customerscanvas.com/docs/cc4/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/cc4/image-placeholder.htm.md) topic. The default value is `fill`.
 
### Optional fillColor
 
fillColor: string

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

The fill color for shapes and placeholders. The default value is `"rgba(112,112,112,255)"` 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/cc4/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[height](https://customerscanvas.com/docs/cc4/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/cc4/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/cc4/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[isVariable](https://customerscanvas.com/docs/cc4/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/cc4/customerscanvas.iframeapi.configuration.defaultconfig.iitempermissionsconfig.htm.md)

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc4/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[itemPermissions](https://customerscanvas.com/docs/cc4/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/cc4/customerscanvas.iframeapi.configuration.defaultconfig.ilocationdefaultconfig.htm.md)

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

The location 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/cc4/customerscanvas.iframeapi.configuration.defaultconfig.imanipulationpermissionsconfig.htm.md)

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc4/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[manipulationPermissions](https://customerscanvas.com/docs/cc4/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/cc4/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[name](https://customerscanvas.com/docs/cc4/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/cc4/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[opacity](https://customerscanvas.com/docs/cc4/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md)

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

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

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

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

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

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

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

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

Inherited from [IItemDefaultConfig](https://customerscanvas.com/docs/cc4/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[visualizationPermissions](https://customerscanvas.com/docs/cc4/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/cc4/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md).[width](https://customerscanvas.com/docs/cc4/customerscanvas.iframeapi.configuration.defaultconfig.iitemdefaultconfig.htm.md)

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