Manage content locations and URL addresses¶
Content locations¶
A content item by itself does not have a place in the content tree and is not visible for a visitor of the website. To be available on the website, it has to be assigned a location ID. A new content item is automatically assigned a location when you publish it.
A content item can have more than one location ID. In such a case you can find it in more than one place in the content tree. A single location can only have one content item in it.
Example
You can use multiple locations for an Article about a local sports team's victory, which you can place in the tree both under Local News and Sports News.
Even if a content item is placed in more than one location, one of the locations is always treated as the main one.
To assign other locations to content, disable the Focus mode, go to the content item's Locations tab and click + Add. Then select the new parent from the content browser.
Hide locations¶
You can manage the availability of content by hiding or revealing it. To do it, go to content item's Locations tab and use the Visibility switcher. Notice that this way only affects a Location, not the Content item. Even if you hide the content in one location, it remains visible in its other locations. You can also hide the content item itself.
When a location is hidden, all of its children (other content items that are under it in the tree) are also automatically hidden. They can only be revealed if the parent location is revealed as well.
A hidden location is invisible for everyone viewing the website. If you're looking for a way to allow only some users to view parts of the content tree, use Sections and combine them with proper permissions.
Swap locations¶
You can swap two content items in their locations by going to the Swap Locations section in the Location tab and selecting a content item to swap with.
Caution
Swapping locations republishes their respective URL aliases. This means that if the swapped content item was accessible by the URL that had a number at the end (added due to a name conflict), then after the swap the number is removed (if possible). The opposite case also applies.
Swapping locations for content item with the same name and parent results in swapping their URL aliases. This means that if the content item was previously accessible by a URL without a number at the end, after the swap it's accessible by a URL with a number at the end (and the other way around).
If at some point there were more than two content items with the same name under the same parent, then result of swapping such content items might not be obvious. The general rule is that the content item that previously had a higher number at the end of its URL alias have its URL alias republished first, resulting in the lowest nonconflicting number (or the lack of) at the end of its URL alias. The content item that previously had a lower number at the end of its URL alias have its URL alias republished second, resulting in the second lowest nonconflicting number at the end of its URL alias.
URL management¶
In your website, you can manage external URL addresses and URL wildcards. You do this in the back office, Admin tab, the URL management node.
For more information about URL management, see Developer Documentation..
Link manager¶
In your website you can link to external websites. To do it, use the URL field or embed links within Rich Text. You can view and update all external links that exist within the website, without having to modify and re-publish the individual content items.
The Link manager tab shows a list of all links in the website. Click any item in the list to see its details and a list of content items that use this URL.
You can change any link in the Link manager. It's then updated in every place where it's used, across all content items.
The Link manager list also shows whether the link is alive or dead in the Status column. The Last checked column displays when the status was last verified.
Note
When you edit a link in the Link manager, you cannot change the URL address to one that already exists in the system.
Once you save the link, it's automatically be marked as "Valid".
URL aliases¶
Each content item can have one or more URL aliases. They're additional URLs that can be used to access this content item.
To add URL aliases, go to the URL tab, and click + Add in the Custom URL aliases for... area.
The URL alias must be unique for the whole installation, regardless of the language.
For each new alias, you can set the following options:
- Language - the language of the content item that the alias redirects to.
- Redirect to alias destination - when toggled on, the alias redirects to the content item's actual URL.
- Place at the website root - when toggled, the alias is created in the root of the website. If this is toggled off, the alias is relative to the parent of the content item.
- SiteAccess - when selected, the prefix of the respective SiteAccess is added to the alias path.
URL wildcards¶
With wildcards, you can replace a portion of the URL address for many content items at the same time, for example, to shorten the path, or to make the path meaningful for the readers.
The URL wildcards tab shows a list of all URL wildcard definitions that exist within the website, and contains all the information about each URL wildcard. You can delete or modify existing entries, or create new ones.
For each URL wildcard definition, you set the wildcard pattern and the destination. Also, you decide whether the link should redirect users to the destination's original address.