Skip to main content
Version: 2026.2

Upgrade Notes

Upgrade to 2026.2.2​

Frontend Build Ships as a Packaged Archive​

The compiled Studio frontend is no longer committed as an expanded src/Resources/public/studio/build/ directory. It now ships as a single archive (build-dist/build-<id>.zip) that is extracted into src/Resources/public/studio/build/ automatically during cache warmup.

pimcore/studio-ui-bundle ^2026.2.1 is now required, as it provides the archive extraction.

Note: Read-only filesystem deployments must run bin/console cache:warmup (or cache:clear) during the build/deploy phase while the bundle directory (usually under vendor/) is still writable. Standard Pimcore deployments already do this. When assets:install runs in copy mode, run cache:warmup before it, otherwise no frontend assets are copied. If the filesystem becomes read-only before the first warmup, the bundle fails with BuildArchiveNotWritableException because there is no build to serve.

Update to 2026.1.0​

PHP and Dependency Requirements​

  • Added support for PHP 8.5.
  • Removed support for PHP 8.3 and Symfony v6.
  • Removed dependency on pimcore/admin-ui-classic-bundle.

Removed ExtJS / Admin Classic​

  • PimcoreHeadlessDocumentsBundle no longer implements PimcoreBundleAdminClassicInterface.
  • Removed BundleAdminClassicTrait and the associated getCssPaths(), getJsPaths(), getEditmodeCssPaths(), and getEditmodeJsPaths() methods.
  • All legacy JS/CSS assets have been deleted: startup.js, event listeners, Datahub config JS, headless document editor, bricks/templates JS, editables, and bootstrap4 vendor assets.
  • The following controllers have been removed:
    • AdminListener
    • HeadlessDocumentController
    • Brick/ConfigController
    • Template/ConfigController
    • DataHub/Config/GetController
    • DataHub/Config/SaveController
  • StudioRouteLoader and config_legacy.yaml have been removed.

Pimcore Studio Integration​

  • Full Pimcore Studio frontend assets are now included under assets/studio/.
  • New Studio backend controllers added:
    • Controller/Studio/DataHub/Config/GetController
    • Controller/Studio/DataHub/Config/UpdateController
  • New service and interface introduced: DataHubConfigurationService / DataHubConfigurationServiceInterface.
  • New schema classes added: DataHubConfigurationDetail, UpdateDataHubConfiguration, UpdateDataHubConfigurationResponse.
  • New events introduced: DataHubConfigurationDetailEvent, DataHubConfigurationUpdateEvent.
  • New WebpackEntryPointProvider added.
  • New translations added: studio.en.yaml, studio_api_docs.en.yaml.
  • New data_hub.yaml configuration file added. It registers the Datahub adapter and is only loaded when the pimcore_data_hub extension is present.

Bug Fixes and Cleanup​

  • Datahub configuration import re-enabled via a fix in PimcoreHeadlessDocumentsExtension together with the new data_hub.yaml config.
  • Doctrine enum type mapping configuration has been removed.

Update to Version 2.3​

General​

  • Dropped support of Pimcore 10, bumped minimum requirement of pimcore/pimcore to ^11.2. Replaced all $request->get() calls with their explicit input source.

Update to Version 2.0​

  • If you are upgrading to Pimcore 11, install the pimcore/admin-ui-classic-bundle bundle.

  • If you are using the symfony-config option for PIMCORE_WRITE_TARGET_HEADLESS_DOCUMENT_BRICKS and PIMCORE_WRITE_TARGET_HEADLESS_DOCUMENT_TEMPLATES, execute the migration:

  1. bin/console pimcore:migrations:execute 'Pimcore\Bundle\HeadlessDocumentsBundle\Migrations\Version20230404095107'.

  2. Add config to your config file:

pimcore_headless_documents:
    config_location:
        headless_templates:
            write_target:
                type: 'symfony-config'
                options:
                    directory: '/var/www/html/var/config/headless_templates'
        headless_bricks:
            write_target:
                type: 'symfony-config'
                options:
                    directory: '/var/www/html/var/config/headless_bricks'