Skip to main content
Version: 2026.1

Upgrade Information

The following steps are necessary when updating to newer versions.

Upgrade to 2026.1.0​

Removed ExtJS / Admin Classic UI Support​

The bundle no longer ships any ExtJS-based frontend code or integrates with the Pimcore Admin Classic UI. The following public assets have been removed:

  • public/js/pimcore/startup.js
  • public/js/pimcore/helper.js
  • public/js/pimcore/interactionAction/showcaseChatInteractionAdapter.js
  • public/js/pimcore/regularAction/customReportsAdapter.js
  • public/css/style.css

Interface / class changes:

PimcoreCopilotShowcaseBundle no longer implements PimcoreBundleAdminClassicInterface and no longer uses BundleAdminClassicTrait. The following methods have been removed from the bundle class:

  • getJsPaths(): array
  • getCssPaths(): array

If you have extended PimcoreCopilotShowcaseBundle or type-hinted against PimcoreBundleAdminClassicInterface, you must remove or update those usages. If you relied on those JavaScript adapters or the CSS, you need to re-implement the equivalent functionality using the new Pimcore Studio UI (see below).

Added Pimcore Studio Backend & UI Bundle Support​

The bundle now requires and integrates with the new Studio-based administration UI. The following packages have been added as required dependencies:

  • pimcore/studio-backend-bundle: ^1.0 || ^2026.1
  • pimcore/studio-ui-bundle: ^1.0 || ^2026.1

Make sure both bundles are registered in your config/bundles.php:

"Pimcore\\Bundle\\StudioBackendBundle\\PimcoreStudioBackendBundle" => ['all' => true],
"Pimcore\\Bundle\\StudioUiBundle\\PimcoreStudioUiBundle" => ['all' => true],

The Symfony security configuration must be updated accordingly. Replace the legacy Pimcore Admin ACL access-control rules with the Studio firewall and access-control rules. Example:

security:
    firewalls:
        pimcore_studio: '%pimcore_studio_backend.firewall_settings%'
        # ...

    access_control:
        - { path: ^/pimcore-studio/api/(docs|docs/json|translations|user/reset-password)$, roles: PUBLIC_ACCESS }
        - { path: ^/pimcore-studio/api, roles: ROLE_PIMCORE_USER }
        - { path: ^/asset/webdav, roles: ROLE_PIMCORE_USER }

Removed Doctrine Enum Mapping​

The custom Doctrine mapping type enum: string has been removed from the test/application configuration. Pimcore 2026.x handles enum types natively. Remove the following from your config/packages/doctrine.yaml (or equivalent) if present:

doctrine:
    dbal:
        connections:
            default:
                mapping_types:
                    enum: string  # remove this line

Removed PO Editor Export Workflow​

The GitHub Actions workflow new-poeditor-export.yml has been removed entirely. Additionally, the REQUIRE_ADMIN_BUNDLE: "true" environment variable has been removed from the static analysis workflow, as it was tied to the now-removed Admin Classic integration.

Updated Dependencies​

  • Dropped support for PHP 8.3 and Symfony v6. Minimum PHP version is now ~8.4.0 || ~8.5.0.
  • Added support for PHP 8.5.