Auto-storage mode of configurations

Overview

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:

Want to learn more?

Sign up for our free beginner training. Boost your credentials through advanced courses and certification.
Register for Sitefinity training and certification.

Was this article helpful?