Skip to main content
Version: 2026.1

Adaptive Design Helper

The DeviceDetector helper makes it easy to implement adaptive design in Pimcore. Adaptive design serves different content or templates based on the detected device type (phone, tablet, desktop), as opposed to responsive design which uses CSS to adapt a single template.

In Twig templates, use the pimcore_device() function for the same functionality.

Using It Anywhere in Your Code​

use Pimcore\Controller\FrontendController;
use Pimcore\Tool\DeviceDetector;
use Symfony\Component\HttpFoundation\Response;

class TestController extends FrontendController
{
    public function testAction(): Response
    {
        $device = DeviceDetector::getInstance();
        $device->getDevice(); // returns "phone", "tablet" or "desktop"

        if($device->isDesktop() || $device->isTablet()) {
            // do something
        }

        // ...
    }
}

Force a Device Type​

Sometimes it's necessary to force a device type. A typical use case is a "Back to Desktop Version" or vice versa link.

To do so, just add the parameter forceDeviceType to your request:

/your/link?forceDeviceType=desktop
/another/link?forceDeviceType=tablet
/a/mobile/link?forceDeviceType=phone

This will set the device to the specified value and Pimcore will remember this setting using a cookie (name: forceDeviceType) till the browser session ends.

Caching​

The Pimcore output-cache is aware of this feature and just works as expected.

If you're using a caching proxy like Varnish you have to take the value of the cookie forceDeviceType into the hash calculation, otherwise there's just one hash for different contents of an URL (phone, tablet, desktop).