---
title: "Breaking Changes in 5.0"
canonical: https://customerscanvas.com/docs/cc5/breaking-changes-v5.htm
archived: true
applies_to:
  - product: "Customer's Canvas On-Premises"
  - product: "Design Editor"
    versions: ["5.35.9", "5.x (may differ)"]
---

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

# Breaking Changes in 5.0

**Applies to:** Customer's Canvas On-Premises; Design Editor 5.35.9, 5.x (may differ) · **Archived documentation**
 
We actively develop Customer's Canvas API and realize that critical changes may be unacceptable and complicate the update process. When some API elements become inconsistent and inconvenient, we first declare them deprecated, and they work in parallel with the new functionality for a while. In further major releases, we delete such deprecated elements.
 
This topic describes breaking changes in configuration parameters, markers, and the IFrame API that appear in Customer's Canvas 5.
 
- Changed configuration parameters
- Removed parameters
- Removed markers
- Changes in the ObjectModel
- Changes in the Web API

## Changed Parameters in Configuration Files
  
### clientConfig.json
 
|  Parameter Name |  Old Value |  New Value |
| --- | --- | --- |
   |  **defaultAssetSelectWidget** |  "GalleryDialog" |  "AssetManager" |
 |  **spellCheckEnabled** |  false |  true |
 |  **canvas.shadowEnabled** |  true |  false |
 |  **canvas.qualityChangeContainersEnabled** |  false |  true |
 |  **canvas.violationWarningButtonsEnabled** |  false |  true |
 |  **rendering.hiResOutputColorSpace** |  "rgb" |  "cmyk" |
 |  **rendering.hiResOutputInStringPlaceholderHintsEnabled** |  true |  false |
 |  **rendering.proofImageFileFormat** |  "png" |  "jpeg" |
 |  **rendering.proofImageCropSafetyLine** |  "bleed" |  "" |
 |  **rendering.proofImageSafetyLinesEnabled** |  false |  true |
 |  **rendering.proofImageInStringPlaceholderHintsEnabled** |  true |  false |
 |  **violationWarningsSettings.qualityMeter.qualityLevels.bad** |  100 |  50 |
 |  **violationWarningsSettings.shapeViolationsEnabled** |  false |  true |
 |  **violationWarningsSettings.textCropViolationWarningEnabled** |  false |  true |
 |  **widgets.BottomToolbar.fullWindowButtonEnabled** |  true |  false |
 |  **widgets.BottomToolbar.rotateButtonEnabled** |  false |  true |
 |  **widgets.BottomToolbar.surfaceSwitch.showThumbnails** |  true |  false |
 |  **widgets.ColorPicker.defaultColorSpace** |  "rgb" |  "cmyk" |
 |  **widgets.common.fontSize.max** |  100 |  1296 |
 |  **widgets.common.leading.max** |  100 |  1296 |
 |  **widgets.common.tracking.min** |  -150 |  -300 |
 |  **widgets.ObjectInspector.aboveCanvasOnSmallScreenEnabled** |  false |  true |
 |  **widgets.ObjectInspector.inStringPlaceholderMode** |  "Single" |  "Multiple" |
 |  **widgets.ObjectInspector.position** |  "Left" |  "Right" |
 |  **widgets.QrCodeDialog.defaultType** |  "QrVCard" |  "QrUrl" |
 |  **widgets.TopToolbar.alignButtonsEnabled** |  false |  true |
 |  **widgets.TopToolbar.deleteButtonEnabled** |  true |  false |
 |  **widgets.TopToolbar.displayAlignButtonsAsDropdown** |  false |  true |
 |  **widgets.TopToolbar.displayZOrderButtonsAsDropdown** |  false |  true |
 
### AppSettings.config
 
|  Parameter Name |  Old Value |  New Value |
| --- | --- | --- |
   |  **DesignFolder** |  "\ProductTemplates\designs" |  "..\assets\designs" |
 |  **MockupFolder** |  "\ProductTemplates\mockups" |  "..\assets\mockups" |
 |  **WatermarkFolder** |  "\ProductTemplates\watermarks" |  "..\assets\helpers" |
 |  **DesignImagesFolder** |  "\ProductTemplates\designImages" |  "..\assets\helpers" |
 |  **PublicGalleryFolder** |  "\PublicGalleryFolder" |  "..\assets\images" |
 |  **UserDataFolder** |  "\UserDataFolder" |  "..\userdata" |
 |  **LoadFontListAsPostScriptNames** |  "False" |  "True" |
 |  **Hinting** |  "Enabled" |  "Auto" |
 |  **SepiaAlgorithm** |  "Standard" |  "MoreBrown" |
 |  **SecureModeEnabled** |  "False" |  "True" |
 
### Aurigma.DesignAtoms.config
 
`VectorObjects.config` is renamed to `Aurigma.DesignAtoms.config` and receives the following changes.
 
|  Parameter Name |  Old Value |  New Value |
| --- | --- | --- |
   |  **FontDirectory** |  "\Fonts" |  "..\assets\fonts" |
 |  **ColorProfilesDirectory** |  "" |  "..\assets\ColorProfiles" |
 
## Removed Configuration Parameters
  
### clientConfig.json
 
|  Parameter Name |  Recommended Replacement |
| --- | --- |
   |  **defaultItemsConfig.<item>.showDeleteButton** |  [IItemToolbarPermissionsConfig](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.configuration.defaultconfig.iitemtoolbarpermissionsconfig.htm.md) |
 |  **defaultItemsConfig.<item>.showEditButton** |  [IItemToolbarPermissionsConfig](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.configuration.defaultconfig.iitemtoolbarpermissionsconfig.htm.md) |
 |  **defaultItemsConfig.<item>.manipulationPermissions.allowProportionalResize** |  [IResizeGripsPermissions](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.configuration.defaultconfig.iresizegripspermissions.htm.md) |
 |  **defaultItemsConfig.<item>.manipulationPermissions.allowArbitraryResize** |  [IResizeGripsPermissions](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.configuration.defaultconfig.iresizegripspermissions.htm.md) |
 |  **rendering.proofImageWatermarkEnabled** |  [IWatermarkConfig](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.configuration.iwatermarkconfig.htm.md) |
 |  **rendering.proofImageWatermarkFontPostScriptName** |  [IWatermarkConfig](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.configuration.iwatermarkconfig.htm.md) |
 |  **rendering.proofImageWatermarkFontSize** |  [IWatermarkConfig](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.configuration.iwatermarkconfig.htm.md) |
 |  **rendering.proofImageWatermarkText** |  [IWatermarkConfig](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.configuration.iwatermarkconfig.htm.md) |
 |  **widgets.BottomToolbar.surfaceSwitchEnabled** |  [ISurfaceSwitchConfig](https://customerscanvas.com/docs/cc5/customerscanvas.baseeditor.configuration.ui.isurfaceswitchconfigparsed.htm.md) |
 |  **widgets.GalleryDialog.defaultTab** |  [ITabDescriptor](https://customerscanvas.com/docs/cc5/customerscanvas.baseeditor.configuration.ui.itabdescriptorparsed.htm.md) |
 |  **widgets.GalleryDialog.downloadPsdAsImage** |  [ITabDescriptor](https://customerscanvas.com/docs/cc5/customerscanvas.baseeditor.configuration.ui.itabdescriptorparsed.htm.md) |
 |  **widgets.GalleryDialog.publicTabEnabled** |  [ITabDescriptor](https://customerscanvas.com/docs/cc5/customerscanvas.baseeditor.configuration.ui.itabdescriptorparsed.htm.md) |
 |  **widgets.GalleryDialog.userTabEnabled** |  [ITabDescriptor](https://customerscanvas.com/docs/cc5/customerscanvas.baseeditor.configuration.ui.itabdescriptorparsed.htm.md) |
 |  **widgets.GalleryDialog.publicFolderName** |  [ITabDescriptor](https://customerscanvas.com/docs/cc5/customerscanvas.baseeditor.configuration.ui.itabdescriptorparsed.htm.md) |
 |  **widgets.GalleryDialog.socialNetworkAppIds** |  [ITabDescriptor](https://customerscanvas.com/docs/cc5/customerscanvas.baseeditor.configuration.ui.itabdescriptorparsed.htm.md) |
 |  **widgets.LeftToolbar** |  [IToolboxConfig](https://customerscanvas.com/docs/cc5/customerscanvas.baseeditor.configuration.ui.itoolboxconfigparsed.htm.md) |
 |  **widgets.ObjectInspector.qualityMeterEnabled** |  [IQualityMeterConfig](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.configuration.iqualitymeterconfig.htm.md) |
 |  **widgets.ObjectInspector.safetyLineViolationWarningEnabled** |  [IViolationWarningsSettingsConfig](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.configuration.iviolationwarningssettingsconfig.htm.md) |
 |  **widgets.ObjectInspector.regionViolationWarningEnabled** |  [IViolationWarningsSettingsConfig](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.configuration.iviolationwarningssettingsconfig.htm.md) |
 |  **widgets.Toolbox.ButtonAction.ToggleObjectInspector** |  [IObjectInspectorConfig](https://customerscanvas.com/docs/cc5/customerscanvas.baseeditor.configuration.ui.iobjectinspectorconfigparsed.htm.md) |
 |  **widgets.TopToolbar.zOrderButtonsEnabled** |  [IZOrderConfig](https://customerscanvas.com/docs/cc5/customerscanvas.baseeditor.configuration.ui.izorderconfigparsed.htm.md) |
 
## Removed Markers
  
|  Marker Name |  Recommended Replacement |
| --- | --- |
   |  `<FRT>` |  ` <RT> ` |
 |  `<IAPSF>` |  ` <IASF> ` |
 |  `<MAAR>` |  ` <MRE> ` |
 |  `<MAPR>` |  ` <MRC> ` |
 |  `<PSED>` |  ` <PAEC> ` |
 |  `<TACS>` |  ` <TACBIU> ` |
 
## Changes in the ObjectModel
  
|  Removed Member |  Recommended Replacement |
| --- | --- |
   |  **Customerscanvas.IframeApi.ObjectModel.Product.setUserId()** |  **[Customerscanvas.IframeApi.RuntimeConfiguration.setUserId()](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.runtimeconfiguration.setuserid.htm.md)** |
 |  **Customerscanvas.IframeApi.ObjectModel.Product.userId** |  **[Customerscanvas.IframeApi.RuntimeConfiguration.getUserId()](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.runtimeconfiguration.getuserid.htm.md)** |
 |  **Customerscanvas.IframeApi.ObjectModel.ISurfacesFromFolder.upMockup** |  **[Customerscanvas.IframeApi.ObjectModel.IMockupFolders](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.objectmodel.imockupfolders.htm.md)** |
 |  **Customerscanvas.IframeApi.ObjectModel.IMockupTemplateHandlerLegacy** |  **[Customerscanvas.IframeApi.ObjectModel.IMockupTemplate](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.objectmodel.imockuptemplate.htm.md)** |
 |  **Customerscanvas.IframeApi.ObjectModel.IMockupTemplateObject** |  **[Customerscanvas.IframeApi.ObjectModel.IMockupTemplate](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.objectmodel.imockuptemplate.htm.md)** |
 |  **Customerscanvas.IframeApi.ObjectModel.ISafetyLine.leftRightMargin** |  **[Customerscanvas.IframeApi.ObjectModel.IMarginHV](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.objectmodel.imarginhv.htm.md)** |
 |  **Customerscanvas.IframeApi.ObjectModel.ISafetyLine.topBottomMargin** |  **[Customerscanvas.IframeApi.ObjectModel.IMarginHV](https://customerscanvas.com/docs/cc5/customerscanvas.iframeapi.objectmodel.imarginhv.htm.md)** |
 
New syntax:
 
- ```
    setMockup(mockup: IMockupTemplate, previewMockups?: IMockupTemplate[], options?: {
        updateRevertData?: boolean;
    }): Promise<Product>;
    ```
 
## Changes in the Web API
  
|  Old Endpoint |  New Endpoint |
| --- | --- |
   |  `~/api/users/{userId}/{stateId}` |  ` ~/api/users/{userId}/states/{stateId}  ` |