The ~/Configuration/AppSettings.config file allows you to configure the location of asset folders, the state file storage, and the security model.

The following snippet shows all available parameters of Customer's Canvas, which you can set up in either the appSettings section of Web.config or in the separate ~/Configuration/AppSettings.config file, with their default values.

        <add key="AllCategoryName" value="all" />
        <add key="RootCategoryName" value="root" />
        <add key="PublicGalleryFolder" value="..\assets\images" />
        <add key="SepiaAlgorithm" value="MoreBrown" />
        <add key="MasterUserId" value="masteruser" />
        <add key="DefaultUserId" value="default" />
        <add key="UserDataFolder" value="..\userdata" />
        <add key="AnonymousModeEnabled" value="False" />
        <add key="DemoModeEnabled" value="False" />
        <add key="FontSubstitutionEnabled" value="True" />
        <add key="SubstitutionFontPostScriptName" value="ArialMT" />
        <add key="DefaultFontPostScriptName" value="ArialMT" />
        <add key="LoadFontListAsPostScriptNames" value="True" />
        <add key="ParagraphTextEnabled" value="False" />
        <add key="RasterizeVectorInSmartFrame" value="False" />
        <add key="StateFileStorageEnabled" value="False" />
        <add key="ApiSecurityKey" value="" />
        <add key="UnsafeHttpWebApiEnabled" value="" />
        <add key="SecureModeEnabled" value="True" />
        <add key="HttpHeaderAllowOriginDomains" value="*" />
        <add key="AppUrl" value="/" />
        <add key="ProofImageDownloadEnabled" value="False" />
        <add key="DefaultPlaceholderCoverModeEnabled" value="False" />
        <add key="LogCleanUpInterval" value="60" />
        <add key="LogLifetimeToArchiving" value="20160" />
        <add key="LogLifetimeToRemoving" value="" />
        <add key="IssueNotificationEmail" value="" />
        <add key="DebugScriptModeEnabled" value="" />
        <add key="DesignFolder" value="..\assets\designs" />
        <add key="MockupFolder" value="..\assets\mockups" />
        <add key="WatermarkFolder" value="..\assets\helpers" />
        <add key="DesignImagesFolder" value="..\assets\helpers" />
        <add key="Hinting" value="Auto" />

All parameters defining paths are either relative or absolute. Relative paths to folders are specified from your site root and start with ~/ (for example, ~/UserDataFolder). Absolute paths are complete ones; they start either with a drive letter (for example, C:\) or \\ for network locations. When you use absolute paths to external folders, make sure that the user account, under which Customer's Canvas runs in ASP.NET/IIS, has the read/write access to the remote folders.

If for some reasons the Postscript names are misspelled, then Customer's Canvas adds Arial to the editor's font list and uses this font for substitutions and new text elements.

Name Description Possible values
AllCategoryName The alias for the category containing images from the public images folder and all its subfolders. The default value is all. string
RootCategoryName The alias for the category containing images from the public images folder. The default value is root. string
PublicGalleryFolder The folder path where public images are stored. The default value is "..\assets\images". folder path
SepiaAlgorithm Sets either a standard Sepia algorithm or a custom algorithm giving a more brown tone. MoreBrown is based on Standard with modified hue, contrast, and saturation. By default, the MoreBrown algorithm is enabled. Standard, MoreBrown
MasterUserId The identifier of the master user. Templates and images that belong to the master user can be used by any user. The default value is masteruser. string
DefaultUserId The identifier of the default user. The default value is default. string
UserDataFolder The folder path where the user data is stored. The default value is "..\userdata". folder path
AnonymousModeEnabled Enables the anonymous site mode. The default value is False. True, False
DemoModeEnabled Enables the demonstration mode. The default value is False. True, False
Font Substitution
FontSubstitutionEnabled Enables the font substitution feature. If a font required by a product is not found on the server, depending on this value, it triggers an exception (for the False value) or substitutes the font (for the True value). If you turn it off, make sure that all fonts from all your templates are imported to Customer's Canvas as explained in Custom Fonts topic. NOTE: For auto-scaled texts, this option is ignored and it always throws an exception if it meets an unknown font in a template. The default value is True. True, False
SubstitutionFontPostScriptName The PostScript name of the font to substitute a missing font with. By default, it is the DefaultFontPostScriptName value. PostScript font name
Font Settings
DefaultFontPostScriptName The PostScript name of the default font used for any new text. The default value is ArialMT. PostScript font name
LoadFontListAsPostScriptNames Allows you to use PostScript names in the FontList config if this parameter is True. If False, the editor reads the names in this list as font family names. The default value is True. True, False
Loading Templates
ParagraphTextEnabled Defines how to load uniformly formatted paragraph text from Photoshop and InDesign templates. If True, the text is loaded as plain bounded text, otherwise - as rich formatted text; it is not recommended enabling this parameter, since it is supported for backward compatibility only. The default value is False. True, False
RasterizeVectorInSmartFrame Defines how to import PDF and AI vector graphics from Photoshop templates. If True, then Customer's Canvas rasterizes images from smart frames, otherwise, they are loaded in a vector form. The <RVC> marker overrides this parameter. The default value is False. True, False
State Files
StateFileStorageEnabled Enables the space-saving mode of state files. This mode is helpful if you use large product template files. The default value is False. True, False
ApiSecurityKey Enables access to the Web API. You have to include this key in every header of HTTPS requests as the X-CustomersCanvasAPIKey field to perform file operations on your server. The Web API works if the value of this key passed in a request matches the value defined in web.config. The value is an arbitrary string (a unique value). For more details, refer to the Deploying Customer's Canvas to Windows Servers topic. string
UnsafeHttpWebApiEnabled Enables access to the Web API through HTTP. The default value is False, which means you can only call the Customer's Canvas Web API through the secure protocol (HTTPS). True, False
SecureModeEnabled Enables secure access to Image Gallery by using tokens. In this mode, before loading the editor, you have to create a tokenId for a single user and pass this token to loadeditor as a configuration parameter. The default value is True. True, False
HttpHeaderAllowOriginDomains Restricts embedding the editor to pages hosted only on listed domains. If your site and Customer's Canvas run on different domains, you can specify your site domain name in HttpHeaderAllowOriginDomains to disallow access to the web-to-print editor from other domains. The value is a comma-separated string. For example, it could be like ",". The "*" default value allows access from any domain. string
AppUrl Defines server's URLs that appear in links to proof images and high-resolution outputs. string
Proof Images
ProofImageDownloadEnabled Enables downloading of proof images instead of opening them in a tab when opening a proof image link in a browser. The default value is False. True, False
Image Placeholders
DefaultPlaceholderCoverModeEnabled Enables the cover mode. If True, the cover mode is enabled for image placeholders without using the <PACM> marker. The default value is False. True, False
Logs and Debugging
LogCleanUpInterval The interval between cleanup runs, in minutes. Every run, Customer's Canvas verifies whether logs get older than LogLifetimeToArchiving or LogLifetimeToRemoving and triggers archiving or removing log files if required. The automatic cleanup does not occur when the application starts. The default value is 60 (an hour). number
LogLifetimeToArchiving The lifetime of logs before archiving them into the ~/Resources/Logs/Archive folder, in minutes. Elmah does not index files in this folder that makes the application launches faster. The default value is 20160 (two weeks). number
LogLifetimeToRemoving The lifetime of logs before removing them from both ~/Resources/Logs/Archive and ~/Resources/Logs folders, in minutes. Note, removing logs can make an error analysis difficult. If LogLifetimeToRemoving is less than LogLifetimeToArchiving, then the archive folder will not contain log files. By default, Customer's Canvas does not remove logs. number
IssueNotificationEmail Customer's Canvas sends error notifications to this email address. You can receive notifications of initialization errors and missing designs, mockups, or fonts. By default, this value is undefined, and the editor does not send email notifications. For more details, refer to the Email Notifications topic. string
DebugScriptModeEnabled Enables the Debug mode for loading JavaScript code. False enables the Release mode when the scripts are minified and combined into a bundle. True enables the Debug mode when the scripts load as separate files and not minified. If you do not specify this parameter, the mode will depend on the application build configuration (for example, if compiled as Debug, Customer's Canvas enables the Debug Script mode). True, False
Content Folders
DesignFolder The folder path where design templates are stored. The default value is "..\assets\designs". folder path
MockupFolder The folder path where product mockups are stored. The default value is "..\assets\mockups". folder path
WatermarkFolder The folder path where watermark images are stored. The default value is "..\assets\helpers". folder path
DesignImagesFolder The folder path where the <BGIMG> images are stored. The default value is "..\assets\helpers". folder path
Hinting Customer's Canvas allows you to specify whether to use font hinting when it is not enabled for the font or not. The Enabled value turns hinting on whereas Disabled turns it off. The Auto value does not turn font hinting on when it is disabled. The default value is Auto. Enabled, Disabled, Auto

See Also