Skip to main content
Version: 2023.1

URLs Based on Documents and Pretty URLs


One essential routing option in Pimcore are the Pimcore Document paths. Along with Pretty URLs they define the address of a Document in the Browser. The Document path and pretty URLs come third in the route processing priority.

Document Path

Every document has a path (in the document tree) that directly represents the address in the browser (e.g.

Document PathDocument PathDocument Path

If there is a document path matching the requested path info, the route then uses the controller, action and view defined in the document's settings, passing them to the dispatcher along with the document itself. See Documents documentation for more details for setting of Documents.

Pretty URL (Custom Slugs / Clean URL)

The Pretty URL setting overrides a document's full path only for the purpose of routing. This is useful for when you would like to create shorter paths or friendly URLs for sharing. A Pretty URL does not redirect to the original URL.

Pretty URLs can be defined in the Documents settings as shown in the screen below:

Pretty URLPretty URLPretty URL

Creating URL's to Documents

The default route is also responsible to assemble the URL's for documents.


<a href="{{ pimcore_document(2) }}">Test-Link</a>

/* OR */

{% set document = pimcore_document(2) %}
<a href="{{ document.fullpath }}">Test-Link</a>

Links to /about

<a href="{{ pimcore_url({'key': 'value'}) }}">Test-Link</a>

Links to /about?key=value