Configuration
Explanation of how to configure models builder
The following configuration option can be set in the application settings (in the appsettings.json
file):
Umbraco.CMS.ModelsBuilder.ModelsMode
determines how Models Builder generates models. Valid values are:Nothing
: Do not generate models.InMemoryAuto
(default): Generate models in a dynamic in-memory assembly.SourceCodeManual
: Generate models in~/umbraco/models
(but do not compile them) whenever the user clicks the "Generate models" button on the Models Builder dashboard in the Settings section.SourceCodeAuto
: Generate models in~/umbraco/models
(but do not compile them) anytime a content type changes.
Umbraco.CMS.ModelsBuilder.ModelsNamespace
(string, default isUmbraco.Cms.Web.Common.PublishedModels
) specifies the generated models' namespace.Umbraco.CMS.ModelsBuilder.FlagOutOfDateModels
(bool, default istrue
) indicates whether out-of-date models (for example after a content type or Data Type has been modified) should be flagged.Umbraco.CMS.ModelsBuilder.ModelsDirectory
(string, default is~/umbraco/models
) indicates where to generate models and manage all files. Has to be a virtual directory (starting with~/
) below the website root (see also:AcceptUnsafeModelsDirectory
below).Umbraco.CMS.ModelsBuilder.AcceptUnsafeModelsDirectory
(bool, default isfalse
) indicates that the directory indicated inModelsDirectory
is allowed to be outside the website root (e.g.~/../../some/place
). Due to this being a potential security risk, it is not allowed by default.Umbraco.CMS.ModelsBuilder.DebugLevel
(int, default is zero) indicates the debug level. Set to greater than zero to enable detailed logging. For internal / development use.
Example Configuration
The example below shows an example configuration using the SourceCodeManual mode.
It is recommended to generate models in your development environment only and change the ModelsMode to Nothing
for your staging and production environments.
Models Builder Dashboard
Models Builder ships with a dashboard in the Settings section of Umbraco's backoffice. The dashboard does three things:
Details on how Models Builder is configured
Provides a way to generate models (in SourceCodeManual mode only)
Reports the last error (if any) that would have prevented models from being properly generated
![](https://docs.umbraco.com/~gitbook/image?url=https%3A%2F%2F3701346516-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FG1Byxw7XfiZAj8zDMCTD%252Fuploads%252Fgit-blob-07969cbfdbac260b5531e3ca2f2c2aa60e98b480%252FModelsBuilderDashboard-v14.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=ce1cf2a9&sv=1)
Last updated