On this page:



The permlink can be used as a single tag or a container tag to return the permanent URL of the article being displayed.

If used as a container tag, the HTML required to output a hyperlink is returned; if used as a single tag, only the URL itself is returned.


Tag will accept the following attributes (case-sensitive):

Specifies the article id, assigned at creation of the article, to link. Can be found on the Articles panel.
Default: unset (current article).
HTML title attribute.
Default: unset.

Common presentational attributes

These attributes, which affect presentation, are shared by many tags. Note that default values can vary among tags.

class="class name"
HTML class to apply to the a tag when used as a container tag.
Default: tag name or unset (see class cross-reference).
style="style rule"
Inline CSS style rule. It’s recommended that you assign CSS rules via class attribute instead.
Default: unset.


Example 1: Single tag

<txp:permlink />

This would result in something like:


Example 2: Container tag

    <txp:title />

This would result in the following:

<a rel="bookmark" href="">Article title</a>

Other tags used: title.

<txp:permlink class="awesome-article">
    <txp:title />

By default <txp:permlink /> returns only a very basic link, which doesn’t allow for customising the link title, or adding a CSS class, etc. Using the tag in its single tag capacity opens up a lot more possibilities.

For example, to give the permanent link an HTML title attribute of the article’s title, and also apply a class to it:

<a class="awesome-article" href="<txp:permlink />">
    <txp:title />

Other tags used: title.

See something wrong in this document? Outdated info, a broken link, faulty code example, or whatever? Please open an issue and we’ll investigate.