docs:router:alias

About

A page alias is an extra path value for a page.

If a page has an alias that corresponds to the path of a missing page, a redirection is performed.

You can see them as symlink or shortcut for a file system.

With the permanent page url, this feature is in a deprecation state.

Why?

Because when moving heavily the files, you end up with a lot of aliases and it becomes really difficult to manage them. The introduction of the permanent page url permits moving the file easily from location without this burden because it's identified by the unique page id

Type

Redirect

A redirect alias is an alias that will perform a permanent redirection.

This type of redirect are automatically created:

when a page was matched with the best end page name redirection algorithm (with at minimal two path parts that match by default)
or when you move a page.

For instance:

if you have a page at the path fruit:pear.
if you move the page to another location such as fruit:tree:pear
the page fruit:tree:pear will get the alias fruit:pear with the type redirect

Synonym

A synonym alias is an alias that will perform a transparent redirection. The page will be served normally as if it was also existing to the synonym path.

Management

You can create, delete and see the aliases for a page with the metadata manager.

Database

You can query the aliases with the following statements:

Simple
Advanced

select * from page_aliases_vw;

select
  p.path as page_path,
  pa.path as alias_path,
  pa.type as alias_type
from
   page_aliases pa
   inner join pages p on pa.UUID = p.UUID;

Table of Contents