Skip to main content
Version: 2026.2

Working With Sites

Introduction​

With Sites, it is possible to create multi domain web applications within Pimcore. Starting point is always a certain node in the Documents tree. From this starting point on, the whole sub tree can appear as an own Site and is reachable with a certain domain.

Configuring Sites​

You can create subsites in Pimcore very easily directly in the context menu of the Document tree:

Configuring SitesConfiguring SitesConfiguring Sites

Your server setup (VHost, ServerAlias) must be configured so that requests for all domains are delegated to Pimcore.

Routing functionalities like Redirects support site-specific configuration. Also, lots of other Pimcore tools and functionalities like Tag & Snippet Management, Marketing Settings (Google Analytics, Google Search Console, Google Tag Manager) and Website Settings are site specific.

Sites in your Code​

Check if Current Request is Inside a Subsite​

if(\Pimcore\Model\Site::isSiteRequest()) { /* ... */ }
{% if pimcore_site_is_request() %}
    {# ... #}
{% endif %}

Working with the Navigation Helper​

See Navigation for more information.

Getting the full path of a document inside a subsite-request​

$document->getRealFullpath(); // returns the path including the site-root
$document->getFullPath(); // returns the path relative to the site-root
document.getRealFullpath()   {# returns the path including the site-root #}
document.getFullPath()  {# returns the path relative to the site-root #}

Getting the root-document of the current site​

if (\Pimcore\Model\Site::isSiteRequest()) {
    $site = \Pimcore\Model\Site::getCurrentSite();
    $navStartNode = $site->getRootDocument();
} else {
    $navStartNode = \Pimcore\Model\Document::getById(1);
}
    {% if pimcore_site_is_request() %}
        {% set site = pimcore_site_current() %}
        {% set navStartNode = site.getRootDocument() %}
    {% else %}
        {% set navStartNode = pimcore_document(1) %}
    {% endif %}

Site Utility Methods​

\Pimcore\Tool\Frontend::getSiteForDocument($document);
\Pimcore\Tool\Frontend::isDocumentInCurrentSite($document);
\Pimcore\Tool\Frontend::isDocumentInSite($site, $document);

Document Preview Navigation with Sites​

Please keep in mind that when previewing documents that have links to different Sites, the navigation may not be working properly due the Iframe Content Security Policies and Cross-origin resource sharing (CORS) policy, please set your own security rules accordingly to your own needs.