A guide displaying the options available in the Settings section in Umbraco CMS backoffice.
The Settings section of the Umbraco backoffice has its own set of default dashboards. In this article, you can get an overview of each dashboard available in the Settings section:
The Welcome dashboard is the first dashboard in the Settings section. Like all dashboards, it is displayed next to the Settings tree and consists of a view that can be customized. The Welcome dashboard consists of links to different resources that can be used when developing your Umbraco website.
The Examine Management dashboard provides an overview of the Examine functionality available directly within the Umbraco backoffice. The Umbraco backoffice allows you to view details about your Examine indexes and searchers - all in one place. You can see which fields are being indexed and rebuild the indexes if there's a problem. You can also test keywords to see what results will be returned.
The Published Status dashboard displays the status of your site in the Published Cache Status section alongwith the Content and Media nodes value. The Caches section provides three options: Memory Cache, Database Cache, and Internals (NuCache).
- Memory Cache - Reloads the in-memory cache by entirely reloading it from the database cache. Use it when you think that the memory cache has not been properly refreshed.
- Database Cache - Rebuilds the database cache that is the content of the
cmsContentNutable. Use it when reloading the Memory Cache is not enough and you think that the database cache has not been properly generated.
- Internals - Lets you trigger a NuCache snapshots collection.
Models builder is a tool that can generate a complete set of strongly-typed published content models for Umbraco. Models are available in both controllers and views. When using the Models Builder, the content cache does not return
IPublishedContentobjects anymore but returns strongly typed models implementing
The Models Builder dashboard displays the following information:
- Details on how Models Builder is configured, that is:
- Provides a button to generate models (if the models mode is
- Reports the last error (if any) that would have prevented models from being properly generated.
Health Checks are used to determine the status of your Umbraco project. It is a handy list of checks to see if your Umbraco installation is configured according to best practices. It's possible to add your custom-built health checks.
You can use the built-in performance profiler to assess the performance when rendering pages. To activate the profiler for a specific page rendering, add
umbDebug=trueto the querystring when requesting the page.
The Profiling dashboard provides a toggle option -
Activate the profiler by defaultto keep the profiler active by default for all page renderings. You can use this option without having to set
umbDebug=trueon each page request. The toggle button sets a cookie named
UMB-DEBUGin your browser, which then activates the profiler automatically.
The Telemetry Data dashboard is a consent screen that is used for collecting system and usage information from your installation. Here, you can see what type of data is being collected and even adjust the level of reporting. Currently, there are three levels available: Minimal, Basic, and Detailed.
Detailed is the default option where the data sent contains:
- Anonymized site ID, Umbraco version, and packages installed.
- Number of: Root nodes, Content nodes, Macros, Media, Document Types, Templates, Languages, Domains, User Group, Users, Members, and Property Editors in use.
- System information: Webserver, server OS, server framework, server OS language, and database provider.
- Configuration settings: Modelsbuilder mode, if custom Umbraco path exists, ASP environment, and if you are in debug mode.
You can see the specific data being sent on each of the levels directly in the Telemetry Data Dashboard.
Additionally, Telemetry Data also sends anonymized, analytical data on package usage in Umbraco. Having solid data on package usage is important for both package developers and the Umbraco ecosystem. For more information about Package Telemetry, see the Package Telemetry section in the Umbraco 9.2 Release Blog Post.