---
title: Setting document aliases
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

Pages (documents) can have an unlimited number of different URLs. To configure URLs, select a document in the content tree of the **Pages** application and open the **Properties -> URLs** tab:

- **Document alias** - the unique name of the document in the given section of the website. Aliases form the _alias path_ of each document, which contains all parent documents up to the root of the site's content tree. The alias path of a document is then used to generate its default URL. For example, if you set a document's alias to _Media_, then the URL is: _\<site domain>/\<parent document alias path>/Media.aspx_
- **Document URL path** - the fields in this section specify an alternate URL for the document, regardless of its position in the website hierarchy. For example, if you select the _Standard URL or wildcard_ Path type and enter _/Medialibrary_,the URL of the document is: _\<domain>/Medialibrary.aspx_

## Adding document aliases

You can add more URLs to documents through _document aliases_. Aliases do not change how the system generates the main URL of a document, they only make the given document available under other URLs.

To create document aliases:

1. Open the **Pages** application.
2. Select the document in the content tree.
3. Open the **Properties -> URLs** tab.
4. Click **Add new alias** in the **Document aliases** section.
5. You can fill in the following properties for each alias:

   | Property                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
   | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
   | Path type                        | You can choose several different URL types for the alias path:<br>**Standard URL or wildcard** - the alias URL is handled by the standard Kentico rewriting engine. Wildcard URLs can be used here, as described in [Wildcard URLs](https://docs.kentico.com/k8/configuring-kentico/configuring-page-urls/wildcard-urls.md).<br>**Route** - the alias URL is processed as an ASP.NET Route pattern.<br>**MVC** - requests to the alias URL are handled as requests for an MVC page. See [Developing sites using the MVC framework](https://docs.kentico.com/k8/developing-websites/developing-sites-using-the-mvc-framework.md) for more information.The selection determines how the system processes the value of the **Path or pattern** property.                                                                                                        |
   | Path or pattern                  | Enter a URL path for the document alias according to the selected **Path type**.<br>For example, if you enter _/Mediagallery_ as the value, you can then access the document under the following URL: _\<domain>/Mediagallery.aspx_                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   | Default controller<br>(MVC only) | The name of the MVC controller containing the action performed when the alias URL is accessed, without the _Controller_ part at the end. For example, if the class is called _NewsMVCController_, enter _NewsMVC_.<br>The system first searches for the specified class in the _CMS.Controllers.\<current site code name>_ namespace. If it is not found there, the _CMS.Controllers.Global_ namespace is searched.                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   | Default action<br>(MVC only)     | Specifies the MVC action that the controller performs when the document is accessed through the alias URL.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   | Alias redirection                | Determines how the system handles (redirects) the URL when the document is accessed through the alias:<br>**Use site settings (default)** - with this option, the redirection behavior follows the _Redirect document aliases to main URL_ setting specified for the website in _Settings -> URLs and SEO_.<br>**Redirect to main URL** - if selected, the system always redirects the alias URL to the document's main URL, i.e. the alias path or custom URL path (if specified).<br>**Do not redirect** - if selected, the system does not redirect the alias URL. This option is recommended if the URL of the alias contains a [wildcard](https://docs.kentico.com/k8/configuring-kentico/configuring-page-urls/wildcard-urls.md).See also: [Search engine optimization](https://docs.kentico.com/k8/configuring-kentico/search-engine-optimization.md) |
   | Culture                          | Determines which [language version](https://docs.kentico.com/k8/multilingual-websites/editing-the-content-of-multilingual-websites.md) of the document the system displays when the page is access through the alias URL.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   | URL extensions                   | Specifies additional supported extensions for the alias URL. To use custom extensions, you need to configure the system according to the instructions in [Custom and extensionless URLs](https://docs.kentico.com/k8/configuring-kentico/configuring-page-urls/custom-and-extensionless-urls.md).<br>This field is optional.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   | Track campaign                   | The system assigns visitors who access the document through the alias to the selected web analytics [Campaign](https://docs.kentico.com/k8/on-line-marketing-features/web-analytics/tracking-campaigns.md).<br>For example, you can create a special alias for a document and then use the alias URL in links contained in marketing materials, such as banners, e-mails etc. This allows the system to monitor how many page views the website receives as a result of the campaign and track the activity of the visitors who arrive as a result.<br>This field is optional.                                                                                                                                                                                                                                                                               |
6. Click **Save**.

If you now switch back to the document's **Properties -> URLs** tab, the new alias appears in the **Document aliases** section. You can add any number of aliases.

## Viewing all aliases on a website

You can access a list of all aliases defined on the website (for all documents).

1. Open the **Pages** application.
2. Select a document with an alias in the content tree.
3. Open the **Properties -> URLs** tab.
4. Edit () any alias.
5. Click **View all aliases** in the page header.

The information provided can help you avoid URL collisions when creating new aliases, and allows you to manage aliases from a single location.

## Automatic creation of new document aliases

You can configure the system to automatically create new document aliases when a user sets a new URL path, alias or extension for a document:

1. Open the **Settings** application.
2. Select the **URLs and SEO** category.
3. Enable the **Remember original URLs when moving documents** setting.
4. Click **Save**.
