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. |
bptb_duplicates_permission | Access to duplicate review: listing groups and members, declining and restoring members, refreshing a group, and queueing an incremental analysis. |
Viewing alternative element trees and their grids additionally requires the core Data Objects permission (objects).
bptb_aet_configuration_permission only covers the configuration panel.
Duplicate review additionally filters by element workspaces: a group is only listed when the user may view its anchor, members the user may not view are withheld, and declining or restoring requires view permission on both sides of the pair.
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
Duplicate analysis runs on its own transport. Without a worker for it, a queued analysis never
executes — the API returns a jobRunId and the run stays pending.
bin/console messenger:consume pimcore_backend_power_tools_duplicates_queue
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.