Short Description

calculates a canonical link and puts it in the pipeline dictionary

Table of Contents

Product Version


Product To Version



New Labels


This custom tag calculates a canonical link and puts it in the pipeline dictionary (default) or in the current session.

Canonical links are used by search engines. If in a site different URL's return the same content, the canonical link found on this page is used to index the content. Missing of such a canonical link may compromise the ranking of the site. Canonical links should be free of any additional user specific identifiers, e.g., sessionIDs, PGIDs, etc.


  action = "( {String} | {ISML expression} )"
  parameters = "( {String} | {ISML expression} )"
  name = "( {simple name} )"
  scope = "( request | session )"
  protocol = "( http | https )"


 <issetcanonicallink scope="request" name="CanonicalLink" protocol="http" action="ViewStandardCatalog-Browse"
  parameters="#ParameterList(Parameter('CategoryDomainName', CategoryBO:DomainName),
    Parameter('CategoryName', CategoryBO:Name))#">


The following attributes can be used to configure <ISSETCANONICALLINK> tag.

A string used to construct URL pipeline action (required).

A parameter list used to construct the URL (optional).

The name under which the canonical URL will be stored in the dictionary or session (required).

The attribute scope specifies if the link should be stored to the session or the pipeline dictionary. By default the link is stored in the pipeline dictionary (optional). The use is similar to <ISSET>

The attribute protocol specifies if the link should use the protocol http, https or the protocol of the current request URL. (optional)

If parameter protocol is not defined this ISML tag acts as it did before the change. (uses the protocol of the current request URL)

Reference - ISML Custom Tags


The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

The Intershop Customer Support website uses only technically necessary cookies. We do not track visitors or have visitors tracked by 3rd parties.

Further information on privacy can be found in the Intershop Privacy Policy and Legal Notice.
Customer Support
Knowledge Base
Product Resources