To define a pretty URL template for a document or topic:
- Select Add template.
-
Place one or more metadata keys between curly brackets. Separate the metadata keys with any character: slashes (
/
) are best-suited.For example:
{product}/{version}/{ft:title}
In topic templates, the
document.
andparents-and-self.
prefixes allow access to the metadata of both the document and the parent topics. See Topic templates metadata. -
Order the templates by priority.
It is possible to drag-and-drop templates.
Pretty URL templates apply in the order in which they are listed. For this reason, place more specific templates (for example, a template with multiple metadata requirements) at the top of the list. Place less specific templates (for example, a template with no requirement) at the bottom.
For more examples of templates, see the use cases section of the Create Perfect Pretty URLs document.
- Defining rules to automatically generate pretty URLs does not override any existing manually-created pretty URLs.
- Two publications can have the same URL, which makes it impossible to choose the target publication. Create unique pretty URLs.
- For a template to apply to a publication, the publication must have all of the metadata keys defined in the template. For this reason, always add a catch-all template (with no requirement and based on a built-in metadata key, such as
ft:title
). - If a publication does not match any requirement, its URL is:
Portal URL + /r/ + the ft:publicationId value of the document + / + ft:tocId value of the topic