Installation

Personalization is an Enterprise bundle. It adds Pimcore's behavioral targeting and content personalization engine, including the Target Groups and Global Targeting Rules panels in Pimcore Studio.

Installation Process

Install the bundle via Composer:

composer require pimcore/personalization-bundle

Enable the bundle in config/bundles.php:

return [
    ...
    Pimcore\Bundle\PersonalizationBundle\PimcorePersonalizationBundle::class => ['all' => true],
    ...
];

Install the bundle via the console:

bin/console pimcore:bundle:install PimcorePersonalizationBundle

The installer creates the targeting permission (see Permissions) and the database tables the targeting engine needs (for example targeting_rules and targeting_target_groups).

Enable targeting

Targeting is disabled by default. Enable it for all visitors with the following configuration:

pimcore_personalization:
    targeting:
        enabled: true

Alternatively, let visitors opt in individually: any visitor whose browser carries a pimcore_targeting_enabled=1 cookie is targeted even if enabled is false. Since privacy laws vary by country, consult your legal team before enabling targeting for all visitors.

Permissions

The bundle registers a single Pimcore user permission:

Permission	Grants
targeting	Access to the Target Groups and Global Targeting Rules panels in Pimcore Studio, and to the underlying Studio API endpoints (list, get, create, update, delete target groups and targeting rules, and reorder rule priority).

Grant targeting to a user or role in Pimcore Studio under Users & Roles. Without it, the Personalization entries in the Studio main navigation are hidden and the API endpoints reject the request.

Uninstallation

Before uninstalling the bundle, remove Target Group references from DataObject classes, custom services and Ecommerce Framework pricing rules manually. The uninstaller then removes the targeting permission and drops the database tables; confirm the prompt to proceed.

Upgrade notes

See Upgrade for version-specific upgrade steps.