Don't miss out Virtual Happy Hour this Friday (April 26).

Try our conversational search powered by Generative AI!

Several bugs in external links and page shortcuts needs attention


I'm having several problems with external links and page shortcuts. There has been several forum posts and bug reports regarding this, but the issues remain unresolved, so this is to sum up and call for some attention:

  • Page shortcuts with hash in URL does not work. The validation message claims I'm using an unsupported protocol, so both the validation logic and the error message is wrong. This is confusing to editors.
  • External links in Url properties does not support "tel:" protocol.
  • External links in Url properties does not support "mailto:" protocol for when you want to add ?subject=whatever
  • External links with url parameters in Url property gets converted to internal links without url parameters if they match a route to an internal page.
  • External links with hashbang in Url property gets converted to internal links without hash data if they match a route to an internal page.

EPiServer – any idea when these issues will be addressed? I'm trying to put off converting Url properties to strings and doing proper validation myself, but I kind of don't want to do that as this should be built in to the CMS.

Tested today with these nuget package versions:


Dec 09, 2014 10:18

I second this post. Except for the last bullet.

I had this but after todays update I can't reproduce it anymore.

Dec 09, 2014 13:56
  • External links with url parameters in Url property gets converted to internal links without url parameters if they match a route to an internal page.

+1 For this.

Dec 10, 2014 15:21

at least this one is fixed in 7.18 ;)

External link of LinkItemCollection is not saving the link with query string "id"

Dec 10, 2014 17:18

This one is killing us as the client on us about how to resolve the problem without waiting for a fix from episerver.  If anyone has any suggestions on how to allow a domain with a querystring of anytype to be allowed would be great.  they are trying to shortcut the page to an external site and any url with a querystring is being thrown an error saying it is not a valid "http://", "mailto:", etc.   Thanks everyone

Dec 16, 2014 18:22

@Joshua – I know exactly what you're talking about. It is very uncomfortable to tell clients to wait for fixes in EPiServer.CMS.UI 7.18.0 just to experience that all their linking issues still remain unsolved. According to the release notes for EPiServer.CMS.UI 7.18.0 some linking isses are said to be fixed and tested, but many issues still remain unsolved (like the ones in my original post). I updated to the latest version (update 47) yesterday but that did not help either.

Dec 18, 2014 10:24

I can't understand why External link is not treaded just as a plain string value. We had to do our own "Link Page" to resolve the issue. 

Dec 18, 2014 21:15

We have the same issue in our project. Customer complains that content editors don’t have the possibility manually edit parameters in query string.

Is it possible to switch off automatic link parsing?

Jan 21, 2015 7:56

It also seems like it does not handle the pattern "/?", as in 

Jan 21, 2015 10:13


Jan 21, 2015 15:13

We're aware of the shortcoming in the link dialog when it comes to custom parameters and hope to adress them in a not to distant future. In the meantime the problems with removed query parameters for internal (routed) links should be resolved in version 7.18 of EPiServer.CMS.UI, and version 7.18 of EPiServer.CMS.Core made it possible to link to actions with parameters.

The automatic parsing of routable urls can't be turned off, and the conversion to internal url's is hopefully the lesser evil. Keeping internal links as static unparsed url's would make them break if pages are renamed or moved. We would also miss out on the use count when deleting or changing content.

If you turn on the original tinyMCE link dialog you're able to edit the url as a plain string.

Jan 22, 2015 9:50

Also I found if url go to internal virtual page, cms can't found corresponding page and crop url to start page.


cropped to

Jan 22, 2015 9:58

@stefan - are you saying that converting of explicitly entered external links to internal ones (stripping all parameters and hash tags on the way) is intentional an will not be fixed? If so we need to convert a lot of Url properties to plain strings, and that is not by far less evil. There are several real world scenarios where an editor needs to make a link to a page, and at the same time pass some parameters. Be it query strings after a "?" or hashes after a "#". How would you go about it?

Jan 22, 2015 10:46

When explicitly selecting "External link", you're effectively saying "this is part of another site, and has nothing to do with this site". Why is this in any way passed through the internal routing? It should really just be a simple string without any validation. If someone enters an invalid URL, it's super easy to track that back to them. And it also allows for whatever they feel like (mailto, tel etc) in there.

Most people copypaste URL's into such fields anyways.

Jan 22, 2015 10:57

@Tarjei - Converting url:s to internal when possible is intentional, but stripping the parameters when doing so is not desirable and is considered a bug. We're also aiming to add the possibility to edit custom parameters. As you point out, there's a need for parameter handling both on internal and external links.

@Arve - Though you have a point, we're currently using the same dialog from different places and the type selection is more of a user convenience since the backing field is a Uri/Url with nothing stating whether that pasted internal link is to be considered external or not. If we look past the problems with lost parameters, is there a real world situation where you don't want to recognize valid internal links?

Feb 04, 2015 13:49

It's a fair point to recognize it as an internal resource. But when it isn't, it should be treated more or less as a plain string, I'd say. Or in the very least be treated correctly as a URL. (I think I had some issues with a copypasted facebook-URL not being "a valid URL" because it ended with /? or something like that)

Might, of course, bring some challenges to how it's handled back end - but the user shouldn't suffer.

Feb 04, 2015 13:54

Yes, the client side validation is way too strict. The aim is to more or less remove the client side validation and let the back-end determine what's valid. Unfortunately we ran into some problems with how System.Uri throws from its getters but is just fine with setting invalid values. The result was that you could save a bad link just fine but things blew up when trying to read it back.

Therefore we temporarily post-poned this change to instead revisit it together with the other shortcomings mentioned.

Feb 04, 2015 14:37

We still have problems trying to link to other languages, running EPiserver 8

We have disabled the language prefix /sv /en and have two hosts mapped in site host settings for each language.

If I choose to add the link as an external link, EPiServer tries to get smart on me and remaps it as an internal page and gets linked to the wrong language.

If I choose to link to another language using the language selector, it only works when I am logged in.

I have managed to link the Swedish site to the English but I cant link the English site back to the Swedish site this way.

If someone enters an URL as external please don't meddle wit it, don't try to get smart and do a lookup just let it be!

Please help, we cant link between languages!

Mar 03, 2015 15:53

Experiencing the same problem . Hoping to have an update soon .

Mar 03, 2015 16:11

We're also having the same issues. This is something that needs to be addressed.

Mar 09, 2015 8:14

I'm also having the same issue, can't insert a link with a querystring, frustrating.

Mar 16, 2015 3:31

The validation in the link dialog should be fixed now: Link validation is too strict in new link dialog

The issues with linking between sites on different languages are fixed in the upcoming EPiServer.CMS.Core 8.3 and are currently being tested by our QA:

Linking between sites with different host to language mappings renders invalid links

Linking between sites with host to language mapping does not work

Mar 16, 2015 8:42

Tried to link to using the field external link and the editor replaced it with the page "searchpage" (stripping the params)

After talking to EPi-support I got the answer this is expected behaviour but that they have submitted a feature request #127002 

Let's hope that we get a field that let's us link to internal pages with query-params =)

Jun 04, 2015 14:09

Has there been any update on the feature request for linking to internal pages with query params? (looks like the link is broken).

Jul 09, 2015 18:24

Hello Everyone,

I have found a Fix for on of the issue mentioned by  Tarjei Olsen and others:

Issue: "

  • External links with url parameters in Url property gets converted to internal links without url parameters if they match a route to an internal page.


We faced the similar problem when adding the External link in TinyMCE it get automatically converted to Internal link ( adding from /lv and link was in /en). i just changed the language from Automatic(Default) to english and it worked.


Episerver converts the external link to internal since it find the page within the page tree of the CMS.

Also when the page or the link is between 2 different languages i.e in /en and /sv and you are linking any page as and external link (which episerver converts to internal link).

You need to change the language from Automatic to English(or the language in which the content exists)

Apr 20, 2016 13:18
* You are NOT allowed to include any hyperlinks in the post because your account hasn't associated to your company. User profile should be updated.