Content Settings
Information on the content settings section
Content settings contains a handful of settings related to the content in the CMS. It includes settings such as allowed upload files, image settings, and much more. All the values in the content settings has default values, so all configuration is optional.
The following snippet will give an overview of the keys and values in the content section including the default values:
Root level settings
In the root level section, that is those without a separate sub section like Imaging, you can configure:
Allow edit invariant from non-default
Invariant properties are properties on a multilingual site that are not varied by culture. This means that they share the same value across all languages added to the website.
When the setting is set to false the invariant properties that are shared between all languages can only be edited from the default language. This means you need access to the default language, in order to edit the property.
When set to true (default) the invariant properties will need to be unlocked before they can be edited. The lock exists in order to make it clear that this change will affect more languages.
Allowed upload file extensions
If greater control is required than available from the DisallowedUploadedFileExtensions setting, this setting can be used to store a list of file extensions. If provided, only files with these extensions can be uploaded via the backoffice.
Allowed media hosts
By default, only relative URLs are allowed when getting URLs for resized images or thumbnails using the ImagesController. If you need absolute URLs you will have to add the allowed hosts to this list. The value could be ["umbraco.com", "www.umbraco.com", "our.umbraco.com"].
Disable delete when referenced
This setting allows you to specify whether a user can delete content or media items that depend on other items. This also includes any descendants that have dependencies. Setting this to true will remove or disable the Delete button.
Disable unpublish when referenced
This setting allows you to specify whether or not users can unpublish content items that depend on other items or have descendants that have dependencies. Setting this to true will disable the Unpublish button.
Disallowed upload files
This setting consists of a list of file extensions that editors shouldn't be allowed to upload via the backoffice.
Error 404 collection
In case of a 404 error (page not found) Umbraco can return a default page instead. This is set here. Notice you can also set a different error page, based on the current culture so a 404 page can be returned in the correct language.
The above example shows what you need to do if you only have a single site that needs to show a custom 404 page. You specify which node that should be shown when a request for a non-existing page is being made. You can specify the node in three ways:
Enter the nodes id (
"ContentId": 1)Enter the node's GUID (
"ContentKey": "4f96ffdd-b969-46a8-949e-7935c41fabc0")Enter the XPath to find the node (
"ContentXPath": "/root/Home//TextPage[@urlName = 'error404'")
If you have multiple sites, with different cultures, setup in your tree then you will need to setup the errors section like below:
If you have more than two sites and forget to add a 404 page and a culture, the default page will act as fallback. Same happens if you for some reason forget to define a hostname on a site.
Hide backoffice logo
This setting can be used to hide the Umbraco logo in backoffice.
Login background image
You can specify your own background image for the login screen here. The image will automatically get an overlay to match backoffice colors. This path is relative to the wwwroot/umbraco path. The default location is: wwwroot/umbraco/assets/img/installer.jpg.
Login logo image
You can specify your own image for the small logo in the top left corner of the login screen. This path is relative to the wwwroot/umbraco path. The default location is: wwwroot/umbraco/assets/img/application/umbraco_logo_white.svg.
Macro errors
This setting allows you to specify how errors in macros should be handled.
Options:
Inline - Default Umbraco behavior, show an inline error within the macro but allow the page to continue rendering.
Silent - Silently suppress the error and do not display the offending macro.
Throw - Throw an exception.
Content - Silently suppress the error, and display custom content reported in the error event args.
Preview badge
This allows you to customize the preview badge being shown when you're previewing a node.
Resolve urls from text string
This setting is used when you're running Umbraco in virtual directories. Setting this to true can increase render time for pages with a large number of links. However, this is required if Umbraco is running in a virtual directory.
Show deprecated property editors
This setting is used for controlling whether or not the Data Types marked as obsolete should be visible in the dropdown when creating new Data Types.
By default this is set to false. To make the obsolete data types visible in the dropdown change the value to true.
Show domain warnings
If you do not configure Domains for each language in a multilingual site then every time you publish your content you get this warning:
Content published: Domains are not configured for multilingual site, please contact an administrator, see log for more information.
If you have a use case for not setting the domains, you can set this setting ShowDomainWarnings to false to stop the warning from displaying.
Show unroutable content warnings
If your routing setup leads to more than one document having the same URL, on publish a warning will be displayed:
Content published: The document does not have a URL, possibly due to a naming collision with another document. More details can be found under Info.
To suppress these warnings, set this option to false.
Content version cleanup policy
The global settings for the scheduled job which cleans historic content versions. These settings can be overridden per Document Type.
Current draft and published versions will never be removed, nor will individual content versions which have been marked as "preventCleanup".
To retain only the current draft and published version, set both the "keep" settings values to 0. The next time the scheduled job runs (hourly) all non-current versions (except those marked "prevent cleanup") will be removed.
Enable cleanup
When set to true, a scheduled job will delete historic content versions that are not retained according to the policy every hour.
When set to false, the scheduled job will not delete any content versions, regardless of any overridden settings for a Document Type.
The dotnet new template provides an appsettings.json file with the default value set to true for all sites.
Keep all versions newer than days
All versions that fall in this period will be kept.
Keep latest version per day for days
For content versions that fall in this period, the most recent version for each day is kept. All previous versions for that day are removed unless marked as preventCleanup.
This variable is independent of KeepAllVersionsNewerThanDays, if both were set to the same value KeepLatestVersionPerDayForDays would never apply as KeepAllVersionsNewerThanDays is considered first.
Imaging
This section is used for managing how Umbraco handles images, allowed attributes and, which properties of an image that should be automatically updated on upload.
Let's break it down.
Image file types
This is a separated list of accepted image formats
Auto fill image properties
You can define what properties should be automatically updated when an image is being uploaded. This means that if you decide to rename the default umbracoWidth and umbracoHeight properties the values in "WidthFieldAlias" and "HeightFieldAlias" need to be updated. This needs to happen in order to automatically populate the values when the image is being uploaded.
Custom media document
If you need to create a custom Media Type to handle images you need to add another object using the custom Media Type alias. Like below. Keep in mind that the width and height attributes have also been changed in this example.
Notifications
Last updated