Skip to content

Latest commit

 

History

History
73 lines (49 loc) · 3.23 KB

index.md

File metadata and controls

73 lines (49 loc) · 3.23 KB
versionFrom meta.Title meta.Description
9.0.0
Umbraco Web Routing Settings
Information on the web routing settings section

Web routing

This section allows you to configure the routing for your solution, all of these settings has either default values, or does not need to be configured. However you might want to tweak these settings in some scenarious, for instance if you're running in a load balanced setup.

An example of a web routing config with default values, and a placeholder for application url can be seen here:

"Umbraco": {
  "CMS": {
    "WebRouting": {
      "TryMatchingEndpointsForAllPages": false,
      "TrySkipIisCustomErrors": false,
      "InternalRedirectPreservesTemplate": false,
      "DisableAlternativeTemplates": false,
      "ValidateAlternativeTemplates": false,
      "DisableFindContentByIdPath": false,
      "DisableRedirectUrlTracking": false,
      "UrlProviderMode": "Auto",
      "UmbracoApplicationUrl": "http://www.mysite.com/"
    }
  }
}

Try matching endpoints for all pages

If this is set to true Umbaco will check if any routed endpoints match a front-end request before the Umbraco dynamic router tries to map the request to an Umbraco content item. This setting should not be nececary as long as the Umbraco catch-all route is registered last.

Try skip IIS custom errors

Defines the value of Response.TrySkipIisCustomErrors when an error (404, 400, 500...) is encountered. You probably want it to be true in order to prevent IIS from displaying its own 404 or 500 pages, and instead have your own page displayed.

Internal redirect preserves template

When true, an internal redirect does not reset the alternative template, if any.

Disable alternative templates

When true, the entire alternative templates feature of Umbraco is disabled.

validateAlternativeTemplates will not load the template from the database. If false the template might not exists in the database. Otherwise the template need to exist in the database.

Validate alternative templates

If set to true alternative templates will be validated

Disable find content by ID path

When true, content can't be found by their ID meaning that urls such as /1234 do not find content with ID 1234.

Disable redirect url tracking

When you move and rename pages in Umbraco, 301 permanent redirects are automatically created, set this to true if you do not want this behavior.

URL provider mode

Will set the URL provider mode, options are:

  • Default: Indicates that the URL provider should do what it has been configured to do.
  • Relative: Indicates that the URL provider should produce relative URLs exclusively.
  • Absolute: Indicates that the URL provider should produce absolute URLs exclusively.
  • Auto: Indicates that the URL provider should determine automatically whether to return relative or absolute URLs.

Umbraco application URL

Defines the Umbraco application URL, i.e. how the server should reach itself. By default, Umbraco will guess that URL from the first request made to the server. Use this setting if the guess is not correct (because you are behind a load-balancer, for example). Format is: http://www.mysite.com/ i.e. it needs to contain the scheme (http/https) and complete hostname.