Auto-storage mode of configurations


Auto-storage mode is the default and recommended configuration storage option. It is a hybrid mode that stores configuration files on both the file system and the database (in table [sf_xml_config_items]).

  • Environment configurations that are part of the system setup are stored in the file system. 
    They are part of the deployment process of the web application and you distribute them as files between different environments.
    Such configurations are the Advanced settings of Sitefinity CMS.
  • Application settings that are part of the Sitefinity CMS website and are modified runtime are stored in the database.

Turn on Auto-storage mode of configurations

When Sitefinity CMS uses FileSystem storage mode, you can switch to Auto-storage mode.

IMPORTANT: Once you switch to Auto-storage mode, you cannot switch back to any different configuration storage option.

To turn on Auto-storage mode of configurations, perform the following:

  1. Open you web.config file.
  2. Make the following transformations:
  3. Save and close the web.config and restart the application.

From this point on, the configuration files will be stored on both the file system and the database. In Auto-storage mode, the system makes the best decision where to store the configurations depending on the context.
When the system is in Auto-storage mode, you can restrict the modification of the file system configurations. For more information, see Read-only mode of configurations.

IMPORTANT: You must not remove existing configuration files from the project's ~/App_Data/Sitefinity/Configuration folder, because Sitefinity CMS continues to use them to read the default values. Only new changes are written to the database.

Explicitly save configurations on the file system in Auto mode

When the system is in Auto-storage mode, if you want to save a configuration intentionally on the file system, you can use one of the following methods:

  • The FileSystemModeRegion in the following way:
  • The SaveSection overload method:

Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

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.

Web Security for Sitefinity Administrators

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.

Foundations of Sitefinity ASP.NET Core Development

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.

Was this article helpful?