Application settings

The following table lists configurations that you can make via the appsettings.json file of your ASP.NET Core Renderer application:

Setting

Type

Description

Url

string

Points to the URL of Sitefinity CMS.

WebServicePath

string

The path to the web service.
The default value is api/default

WebServiceApiKey

string

A key that you use to restrict the web service to be accessible only from the Renderer application.

HostHeaderName

string

The user when the Renderer application is hosted in Azure.
For more information, see Hosting configurations » Configure the Renderer for Azure App Services.

DateFormatSource

string

Determines how to handle dates.
You can set it to Client or Server, depending on which timezone you want to use – the one of the server (Sitefinity CMS) or the one of the client (browser).
For more information, see Format the date and time fields.

ServerDateFormat

string

If you are using Server as the date format source, this is a custom date-time string, with which all dates are formatted.
For example, yyyy-MM-ddTHH:mm:ss.fff

LocalValidationKey or
RemoteValidationKey

string

The key used when you host the Renderer in Sitefinity Cloud.
For more information, see ASP.NET Core Renderer in Sitefinity Cloud.

IgnoreSslErrors

bool

Use this setting only during development, in case the SSL certificate of Sitefinity CMS may not be recognized as valid.
Its value can be true or false

DefaultPageCacheExpiration

number

The default value of the page cache expiration in seconds for all pages.
The default value is 60 seconds.

PropagateWidgetExceptions

bool

NOTE: This setting is available as of version Sitefinity 15.2.8421.

Controls whether an error, which has occurred in a widget, will propagate to page level and return 500 error status code. When set to true, the widget error is propagated and the page returns 500.
When set to false, the widget error is only logged, whereas the widget is not rendered and the page returns 200.
The default value is false

PageRelatedFields

string

NOTE: This setting is available as of version Sitefinity 15.2.8421.

Controls which related data/media fields will be requested alongside the main layout request for a page. These fields can be retrieved from dependency injection (DI) via the IRequestContext.PageNode property.

Example configuration: `["Image", "News"]`

Want to learn more?
Enhance your Sitefinity skills by enrolling in free training sessions. Become Sitefinity certified through Progress Education Community to strengthen your professional credentials.
New to Sitefinity?