Is this really the version you are looking for? Kentico Xperience 9 Documentation is no longer updated. Use the switcher in the header to choose your product version.
You can configure settings for sites in the Settings application.
There are two basic types of settings:
Note
Some settings are only available as global settings.
Settings that alter page markup on the live site may not come into effect immediately. You may need to wait for the site's output cache to expire or clear the cache manually in the System application.
There is a very large number of settings in Kentico . To find a particular setting among all the categories:
In the Settings application, select the root of the settings tree (Settings).
Type the name of the setting or related words into the field at the top of the page.
Click Search.
The page displays all settings that contain the search text in their name. You can edit the values of the settings directly.
To reset settings to their default values:
All settings in the given category now have the default value defined in the Default value property of the corresponding keys.
You can export the values of all settings in the selected category to a text file. Click Export these settings in the header of the setting page. Exporting settings can be useful, for example when consulting issues with Kentico support.
The Kentico API allows you to check the values of settings in your code. You can load values of both the default and custom settings.
Use the following methods of the SettingsKeyInfoProvider class according to the data type of the required setting:
The methods accept a string parameter that identifies the setting in the following format: <site code name>.<settings key code name>
Note: When loading global-only settings, only enter the code name of the required settings key in the parameter.
For example:
using CMS.DataEngine;
using CMS.SiteProvider;
...
string value = SettingsKeyInfoProvider.GetValue(SiteContext.CurrentSiteName + ".CMSDefaultAliasPath");Macro expressions allow you to:
You can load values of both the default and custom settings.
Use the following expression to get setting values inside macros: Settings.<settings key code name>
For example:
{% Settings.CMSStoreFilesInFileSystem %}The macro returns the setting's value for the currently running site (or the global value for global-only settings). If you need to access the global value of a setting, you can use the following macro expression: GlobalObjects.SettingsKeys.<settings key code name>.KeyValue