Links resolving issue

In this article, we will show you what to check and change if you are having issues to display correct links to images or documents. The most common problem is that links are not resolved (they point to a relative path in the HTML output), or that the rendered URLs contain an additional “~” sign.
  1. If your CMS was upgraded from version 5.5R2, please check the following setting and uncheck it (set its value to false): Site Manager -> Settings -> System -> Files -> <optionally select your site> -> Use site-specific subfolders for custom files folder
  2. Check your project folder for the following file ~/App_Browsers/outputfilter.browser
  3. If you are using Classic mode setting for your application pool, you should change it to Integrated and modify your web.config file as described in 4. below
  4. Make sure that your web.config file contains the following code in the httpModules section:
    <add name="XHtmlModule" type="CMS.CMSOutputFilter.OutputFilterModule, CMS.OutputFilter"/>
Please note: the order of the lines in the web.config file is important. Below is a sample order for Integrated pipeline mode of the application pool (it is only an example, the System.Web.Routing.UrlRoutingModule version may differ according your .Net version):

      <add name="XHtmlModule" type="CMS.CMSOutputFilter.OutputFilterModule, CMS.OutputFilter" />
      <add name="CMSApplicationModule" type="CMS..CMSHelper.CMSApplicationModule, CMS.CMSHelper" />

    <modules runAllManagedModulesForAllRequests="true">
      <remove name="WebDAVModule" />
      <remove name="XHtmlModule" />
      <remove name="CMSApplicationModule" />
      <remove name="UrlRoutingModule" />
      <add name="UrlRoutingModule" type="System.Web.Routing.UrlRoutingModule,System.Web.Routing, Version=,Culture=neutral, PublicKeyToken=31BF3856AD364E35" />
      <add name="XHtmlModule" type="CMS..CMSOutputFilter.OutputFilterModule, CMS.OutputFilter" />
      <add name="CMSApplicationModule" preCondition="managedHandler" type="CMS.CMSHelper.CMSApplicationModule, CMS.CMSHelper" />
    <validation validateIntegratedModeConfiguration="false" />

See also: Installing Kentico CMS on remote server using .Net 4.0 and Integrated pipeline mode on IIS7+

Applies to: Kentico CMS 6.0
Share this article on   LinkedIn

Juraj Ondrus

Hi, I am the Technical support leader at Kentico. I'm here to help you use Kentico and get as much as possible out of it.