Simplifying upgrades with Adobe Commerce

Upgrade icon image

Keeping your Adobe Commerce instance updated is key to maintaining a platform that has the latest features, and is secure, performant, and reliable. Enabling our customers to run predictable, repeatable, and frictionless upgrades is a priority for the Adobe Commerce product team. Over the past 18 months, we have made several important changes to our release process, including a predictable lifecycle and release policy, beta and pre-release programs, and streamlined release vehicles. We have also simplified the upgrade process with the introduction of quality patches, the upgrade compatibility tool, and a new marketplace extension compliance policy. As part of our continued efforts to simplify the upgrade process, we are excited to announce the new Upgrade best practices documentation, enhancements to the upgrade compatibility tool, and updated Marketplace compatibility policies.

Upgrade Best Practices

Adobe Commerce is known for its flexibility and ease of customization. It provides powerful extensibility points for merchants to customize the UI, extend the API and core services, and integrate with third-party systems. To ensure efficient upgrades, it is important to make these customizations the right way.  That is why we are excited to announce our Upgrade best practices guide drawn from the vast knowledge and experience of our partners, merchants, and Adobe experts. The guide describes in detail:

upgrade best practices

Upgrade best practices

Upgrade compatibility tool enhancements

The upgrade compatibility tool is a command-line interface (CLI) tool that analyzes customizations on a given Adobe Commerce instance and identifies code that might need to be updated prior to an upgrade. In the initial release, the upgrade compatibility tool validated compatibility for PHP and the GraphQL API. With this release, we expanded the scope of coverage. With the enhancements the tool can now:

sample upgrade compatibility report

Sample upgrade compatibility report

We are actively expanding the scope of the upgrade compatibility tool, based on community feedback on which factors impact upgrades the most. You can join our #upgrade-compatibility-tool slack channel to get support from the Adobe product team and the community, as well as to help guide the future direction of this tool.

Marketplace Compatibility Policy for Extensions

Adobe is taking proactive measures to ensure the quality and compatibility of extensions in the marketplace. We have introduced a new compatibility policy that requires vendors to confirm compatibility of extensions for each minor release within 90 days and patch release within 30 days of becoming generally available. Extensions that do not meet these guidelines will be delisted from the Marketplace at the expiration of the deadline. In addition, the Commerce Marketplace Extension Quality Program validates submissions for baseline functionality, code quality, absence of malware, and more. This policy gives our merchants confidence in the extensions they deploy to meet their business needs.

Planning for future upgrades

With PHP 7.3 reaching end of support in December 2021, and Adobe Commerce 2.3 reaching end of support in April 2022, it is important that our customers update their environments to the latest version of Adobe Commerce. This will enable PCI compliance and ensure access to ongoing security updates, support, and new functionality. As Marketplace extensions are a key part of upgrades, and can be a major blocker if not compatible with the target version, the new Marketplace compatibility policy will help accelerate availability of extensions for new releases of Adobe Commerce making it easier for customers to upgrade. The new Upgrade best practices guide and updates to the upgrade compatibility tool provide partners and customers with the assets they need to plan for and simplify their upgrade process.

If you are using these older versions of PHP and Adobe Commerce, we encourage you to get started on your upgrade plan at the earliest.