search

Install Default Data Settings

Information on configuration allowing for the modification of default data installed in new projects

When Umbraco is installed for the first time, it creates a set of default data. These include a language, some Data Types, and some Media and Member Types.

In certain setups, you may want to take control over what is installed and opt-out of the creation of certain items.

When working in a team and using Umbraco Deploy for schema updates, consider your colleague's local project setup. The default installed data may not always be useful.

For example, if different languages are set up in Umbraco, it's better not to recreate them from the default language (en-US). In other situations, certain Umbraco default Data, Member and Media Types may not be required.

The following example configuration shows how this default data installation can be customized:

"Umbraco": {
  "CMS": {
  "InstallDefaultData": {
      "Languages": {
        "InstallData": "Values",
        "Values": [
          "en-US"
        ]
      },
      "DataTypes": {
        "InstallData": "ExceptValues",
        "Values": [
          "0225af17-b302-49cb-9176-b9f35cab9c17"
        ]
      },
      "MediaTypes": {
        "InstallData": "All",
      },
      "MemberTypes": {
        "InstallData": "None"
      }
    }
  }
}

Each InstallData setting can be one of the following values:

  • All - all default data for the type will be installed (this is the default behavior if the configuration is omitted).

  • Values - only the default data specified will be installed. For languages, the values are the ISO codes for the language. For all other types, the Guid for the type should be listed.

  • ExceptValues - all default data except those specified will be installed.

  • None - no default data of the type will be installed.

circle-exclamation

Be cautious when changing a Data Type configuration, as there are some dependencies between the different types. Make sure to check the reference information in the info tab to ensure they are not referenced somewhere else.

For example, if you check the info tab of the Label (bigint) Data Type, you can see that it is referenced by the Media Types:

Data Type referenced by Media Type

hashtag
Data Identifiers

For DataTypes, MediaTypes and MemberTypes the Guid identifiers for the default data items need to be provided in the Values collection.

For Languages, the Values collection expects the standard language ISO codes to be provided. Given this code is enough to fully specify a language, it's possible to use this collection to install additional default data.

As an example, the following configuration would omit the default "English (United States)" language and instead install the "English (United Kingdom)" and "Italian" languages. As "English (United Kingdom)" is provided first, it would be created as Umbraco's default language for content creation.

hashtag
Reference

The Guid values representing the default Data, Media, and Member Types installed are as follows.

Data types:

Media types:

Member types:

PreviousIndexing settingsNextLogging settings

Last updated

Was this helpful?