Skip to main content
Version: 2025.4

Upgrade Information

Following steps are necessary during updating to newer versions.

Upgrade to 3.4.0​

With this version and the Pimcore Studio integration, we introduced a new architecture for schema definitions. We are moving from the tree-based schema definition (also used in the grid configuration of the Admin Classic UI) to a pipeline-based approach (also used in Studio UI grids). This change is driven by technical and maintenance considerations, as the tree-based implementation has limitations in terms of consistency, flexibility, and extensibility. The new architecture aligns with how Pimcore Studio UI grids work internally, streamlining the implementation across adapters and improving consistency, stability, and extensibility.

Existing configurations created in the Classic UI remain functional and continue to execute without changes. However, a configuration must be fully migrated to the new pipeline-based format before it can be edited in Pimcore Studio. Migration must be done manually by following the steps provided in the Pimcore Studio UI.

Read-only support for the legacy tree-based schema definitions will be removed in version 2027.1.0.

Upgrade to 3.0.0​

  • File name configuration has been changed. Please make sure to extract the date/time format options into the new "date format for filename" field. Additionally, the format options have to be adjusted to the Carbon format. For example, %Y-%m-%d_%H-%i-%s has to be changed to Y-m-d_H-i-s. Further documentation on Carbon format options is available here.
  • Change return type to bool of exportData in ExporterTypeInterface and AbstractExporter

Upgrade to 2.2.0​

  • The folder where the temporary file and the output file will be generated can now be configured in the flysystem configuration.

Upgrade to 2.1.0​

  • Make sure all running exports are done prior upgrading to version 2.1.0.

Upgrade to 2.0.0​

  • Make sure all running exports are done prior upgrading to version 2.0.0.

Upgrade to 1.1.0​

  • Execute all migrations of the bundle.

Upgrade to Pimcore X​

  • Update to latest (allowed) bundle version in Pimcore 6.9 and execute all migrations.
  • Then update to Pimcore X.