--- title: "Upgrading the Design Editor" canonical: https://customerscanvas.com/docs/cc6/upgrading-customers-canvas.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/). # Upgrading the Design Editor **Applies to:** Customer's Canvas On-Premises; Design Editor 6.15.0, 6.x (may differ) · **Archived documentation** Aurigma updates Customer's Canvas on a regular basis. Once a new version is released, it appears in your account in [My Licenses & Downloads↗](https://customerscanvas.com/account/licenses). You may want to test new features of the Design Editor and see how they can improve your project. This topic will help you ensure a smooth transition to the new version of the editor. **Important** When you need to run both old and new versions of the Design Editor, run them in separate application pools. If you customized a UI theme for earlier versions, it may become incompatible with new versions of the Design Editor. ## The Standard Upgrade Process When there are no breaking changes between the old and new versions, the upgrade process includes the following steps: 1. In the File Explorer, navigate to your application's web directory, for example, `D:\inetpub\CustomersCanvas\`. 2. Unzip `cc-` from the package `CustomersCanvasServer.zip` to this folder. 3. Copy your configuration changes, if any, from the `\cc-\Configuration` folder: - `clientConfig.json` - `AppSettings.config`, `Aurigma.DesignAtoms.config`, `FileCache.config`, and `Converters.config` - `TemplateConfigShortcuts.json` - `translations.json` - Custom CSS - Email notifications - Themes 4. In the IIS manager, stop your application. 5. In the **Basic Settings** of your application, change the **Physical path** to the new folder (`D:\inetpub\CustomersCanvas\cc-`). 6. In the IIS manager, start your application. ## Version-specific upgrading instructions Since the Design Editor introduced significant changes in `6.0.0`, `5.33.0`, `5.5.0` and `5.1.0`, you must perform additional steps to upgrade through these versions. If you now run, for example, Design Editor `5.0`, you can upgrade through these versions in one go. ### 6.0.0 #### Using System Fonts Design Editor `6.0` has stopped using systems fonts. Now, you must store all the fonts available to your users in the asset folder defined in the [FontDirectory](https://customerscanvas.com/docs/cc6/aurigma-designatoms-config.htm.md) configuration parameter. After you have unzipped the new version and restored the old configuration files, you must run the Font Migration Tool to find and copy system fonts used in your products and configs. #### Using Classic Text Engine All types of text elements now support rich formatting and can be edited right on the canvas using the new [WYSIWYG text engine](https://customerscanvas.com/docs/cc6/text-engines.htm.md). However, the new engine does not support some features yet, and you can still enable the Rich text editor and text pop-up boxes to edit such features. After you have restored your old configuration files, you can set the [LegacyTextEngineEnabled](https://customerscanvas.com/docs/cc6/aurigma-designatoms-config.htm.md) parameter to `true` in `Aurigma.DesignAtoms.config`. ### 5.33.0 In version 5.33, we have changed the way we define the [bleed zone and print area size](https://customerscanvas.com/docs/cc6/safety-lines.htm.md). Earlier, if you wanted to create a 3.5x2" business card with 1/8" bleed, you created a 3.75x2.25" design and put a safety line inside it. But now, when you create a 3.5x2" design, the bleed zone will expand outside the design. This may result in changing the product size and unnecessary safety lines. If you encounter this, you can either rework the design and change the Bleed and Slug settings or enable the old behavior. In the latter case, set **LegacyIdmlBleedParsingEnabled** to `true` in `Aurigma.DesignAtoms.config`. ### 5.5.0 After you have restored your old configuration files, in **\Configuration\AuthSettings.config**, find: ``` ``` and replace it with: ``` ``` ### 5.1.0 Upgrade through `5.1.0` requires additional changes only if you enabled the [auto-start provider](https://customerscanvas.com/docs/cc6/scalability.htm.md). In this case, replace the **<serviceAutoStartProviders>** node in `%WINDIR%\System32\inetsrv\config\applicationHost.config` with the following: ``` ``` ## Troubleshooting #### Some fonts are missing in your products When products are loaded to the editor or rendered to print files, fonts, which were available before, get missed after the upgrade. ##### Solution This may occur if the products refer to system fonts. Since Design Editor `6.0` has stopped using them, use the FontMigrationTool to scan your products for references to system fonts and copy those fonts to the application's folder. In [My Licenses & Downloads↗](https://customerscanvas.com/account/licenses), you can find the Font Migration Tool that helps you analyze state files, templates, and mockups and copy the system fonts used in those files to the asset folder. To run this tool: 1. Unzip **FontMigrationTool** from the distribution package. 2. In the `App.config` file, find **<appSettings>** and replace the default settings with the folder paths where you store the assets. 3. Run `FontMigrationTool.exe` and follow the instructions in `readme.md`. To ensure that print files use the correct fonts, you can disable the [font substitution feature](https://customerscanvas.com/docs/cc6/appsettings-config.htm.md) in `AppSettings.config`. #### Rich text editor opens for some text elements Some text elements can be edited on the canvas, although the Rich text editor may open for others. ##### Solution All types of text elements now support rich formatting and can be edited right on the canvas using the new WYSIWYG text engine. However, the new engine does not support some features yet and can open the Rich text editor and text pop-up boxes to edit such features. if you want to make this behavior consistent or just enable the old text engine, you can set the [LegacyTextEngineEnabled](https://customerscanvas.com/docs/cc6/aurigma-designatoms-config.htm.md) parameter to `true` in `Aurigma.DesignAtoms.config`. #### Size of products based on InDesign templates changed Old IDML templates with defined bleed and slug areas open with a different size. ##### Solution The way of defining the bleed zone has changed in [version 5.33](https://customerscanvas.com/docs/cc6/safety-lines.htm.md), bringing the user experience closer to Adobe InDesign and other professional tools. To fix this issue, you can either change the product size manually to comply with the new approach or use the **LegacyIdmlBleedParsingEnabled** parameter to return to the old approach. You can set this parameter to `true` in `Aurigma.DesignAtoms.config` to load IDML templates with bleed and slug areas as it was implemented in version 5.32. ## See Also ### Manual - [breaking-changes-v5.htm](https://customerscanvas.com/docs/cc6/breaking-changes-v5.htm.md) - [clientConfig.json](https://customerscanvas.com/docs/cc6/client-config.htm.md) - [Web.config](https://customerscanvas.com/docs/cc6/web-config.htm.md)