Each Sitefinity CMS instance has a default configurations set. Each site that belongs to this instance can have its own, site-specific settings. To do this, you need to break the inheritance from the default configurations and create site-specific settings.
The default configurations are saved on the file system. They cannot be changed during runtime. Out of the default configurations, you can create site-specific settings. These settings are saved in the database. They can be changed runtime. Once you create site-specific configurations, they become settings.
PREREQUISITES: To create site-specific settings, your Sitefinity CMS instance must be in auto-storage mode of the configurations. For more information, see Auto-storage mode of configurations.
If you have configured Sitefinity CMS in continuous delivery, site-specific settings cannot be part of the continuous delivery process, because they belong to the database.
Unless a site is configured by deployment, you create and modify its settings on the Production environment.
If you have set your sites to be configured by deployment packages via the continuous delivery process, you cannot create site-specific settings on the next environment. For more information, see Deployment mode of websites.
IMPORTANT: When using config transformations from web.config appSettings section, you lose the ability to edit those configurations per site.
ConfigElement
[ConfigurationProperty("background", IsKey = true)]
SiteSettings
Sitemap
NameValueCollection
To create site-specific settings, on your production environment, perform the following:
RECOMMENDATION: When reading site-specific settings, we recommend using Config.Get<DummyConfig>(). It will respect the current site context and load any site-specific values for it. It also caches the configuration and increases performance. We do not recommend using ConfigManager.GetManager().GetSection<DummyConfig>(), because it does not load site-specific values and does not cache the loaded configurations.
Config.Get<DummyConfig>()
ConfigManager.GetManager().GetSection<DummyConfig>()
To work with site-specific settings with the native API, use the following code sample:
Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.
This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.
This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.
The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.
To submit feedback, please update your cookie settings and allow the usage of Functional cookies.
Your feedback about this content is important