Installation of the Backend Power Tools Bundle
Backend Power Tools is an enterprise bundle. It requires a Pimcore enterprise subscription.
Prerequisites
The bundle requires Pimcore 2026.2 or later and PHP 8.4 or 8.5.
Installation
- Install the package:
composer require pimcore/backend-power-tools-bundle
- Enable the bundle in
config/bundles.php:
use Pimcore\Bundle\BackendPowerToolsBundle\PimcoreBackendPowerToolsBundle;
// ...
return [
// ...
PimcoreBackendPowerToolsBundle::class => ['all' => true],
// ...
];
- Install the bundle:
bin/console pimcore:bundle:install PimcoreBackendPowerToolsBundle
User Permissions
The bundle adds these permissions. Grant them to the users and roles that should reach each feature.
| Permission | Grants |
|---|---|
bptb_aet_configuration_permission | Manages Alternative Element Tree configurations. |
bptb_bookmark_list_permission | Access to bookmark lists, including creating and editing them. |
bptb_bookmark_list_share_permission | Shares a bookmark list with other users and roles. |
Viewing alternative element trees and their grids additionally requires the core Data Objects permission (objects).
bptb_aet_configuration_permission only covers the configuration panel.
The Theme Manager reuses the Studio Backend permission system_appearance_settings
("Appearance & Branding Settings").
Message Queue
Alternative Element Trees are built asynchronously through the Symfony Messenger queue. Building starts automatically as soon as a tree configuration or a data object is saved.
Messages use the pimcore_alternative_element_trees transport, so run a worker for it. Without a worker, trees are
never built.
bin/console messenger:consume pimcore_alternative_element_trees
Bookmark Lists and the Theme Manager do not use the queue.
Deployment Hint
In pipelines without database access, Doctrine ORM cache warm-up fails because it tries to detect the database version. Configure the server version explicitly in the default DBAL connection:
doctrine:
dbal:
default_connection: default
connections:
default:
# ...
server_version: mariadb-10.11.0
Uninstallation
Uninstalling the bundle leaves the bundle_backend_power_tools_* tables in place. Drop them manually afterwards.