Important - Don’t Change the Mosaico Docker Image Version Without Good Reason
The Mosaico module integrates the open source email editor Mosaico, which is provided via a Docker image and hosted as a cloud service by the operator. We want to clarify an important point about the referenced Docker image version.
What does that mean?
The Docker image version is intentionally selected to be compatible with the current version of the Mosaico module. Changing it manually may lead to unexpected behavior or incompatibilities.
This does not mean that the module version and the Docker image version need to be the same (for example, Mosaico module 1.0.0 may rely on editor image 2.2.4). What matters is that the versions are tested together and approved as compatible. The approved Docker image version for an xRM release will always be referenced in the mosaico alias definition of the module release.
While it may be tempting to update the image to a newer release or align version numbers, doing so without proper validation can result in:
- Broken editor functionality
- Incompatible API behavior
- Data handling problems
Recommendation
- Only change the referenced Docker image version if you fully understand the impact and have verified compatibility in a controlled test environment.
- If a version update is required, always go through proper testing and validation before applying it to production systems.