The system provides various settings that allow users in the administration to enable and configure system features.
You can access the settings in the Settings application.
Always select Save to confirm any changes that you make in the settings.
There is a large number of settings in Xperience. To find a particular setting among all the categories:
The page displays all settings that contain the search text in their name or description text (tooltip). You can edit the values of the settings directly in the search results.
Application settings
In addition to the settings available in the Xperience administration, the system's functionality can be adjusted via low-level application configuration keys. These keys are managed using ASP.NET Core configuration providers (opens in a new tab). By default, Xperience projects contain an appsettings.json file for this purpose.
For more information, see Reference - Configuration keys.
If you wish to adjust custom functionality based on specific Xperience settings, you need to retrieve and reflect their values in your custom code.
To load the values of settings, use ISettingsService (we recommend using dependency injection to instantiate system service classes). The service exposes an indexer that you can use to access the values of individual settings. Setting keys are identified by their code names.
The service always returns string values. If you need to cast the setting value to a different type, use IConversionService.
using CMS.Core;
...
// Contains an instance of the settings service (e.g., obtained using dependency injection)
private readonly ISettingsService settingsService;
// Contains an instance of the conversion service (e.g., obtained using dependency injection)
private readonly IConversionService conversionService;
// Checks if Continuous Integration is enabled
bool continuousIntegrationEnabled = conversionService.GetBoolean(settingsService["CMSEnableCI"], false);