Upgrade to brXM 14

This guide explains how to upgrade your project from brXM 13 to brXM 14.

Bloomreach Content uses Semantic Versioning. Major version upgrades, such as from 13 to 14, may introduce breaking changes. You must update your project to accommodate these changes. This documentation outlines the required steps.

Version 14 introduces significant changes, especially in the security model and configuration. Before you begin, review the general introduction to Bloomreach Content upgrades. Follow the general upgrade process as described. Do not skip or alter any steps in the process.

Next, review the list of relevant changes between version 13 and 14. This page explains the rationale for each change and will help you understand the required updates.

Before starting the main upgrade steps, complete the preparation step for upgrading a v13 project to v14. Completing this preparation step before following the general instructions is recommended.

After preparation, follow the detailed upgrade steps to complete the migration to version 14.

The most substantial changes in this upgrade are related to the security configuration. For details and background, see Security Configuration Overhaul.