Upgrade Procedure: Customizations and Integrations

If you’ve developed customizations, reports, integrations, or independent software vendor (ISV) solutions based on earlier versions of MYOB Acumatica, changes introduced since Version 2025 R2 Service Pack (Build 25.201.0227) may affect your solutions. Below you'll find practical guidance to help you avoid upgrade issues and keep your solutions running smoothly.

Important: Review the full list of changes in Reference List of Changes before starting your upgrade.

Before the Upgrade

In a development environment, test your customizations before a production upgrade to MYOB Acumatica 2026.1.1:

Deploy a new instance of MYOB Acumatica 2026.1.1. (See Deploying MYOB Acumatica Instances for details.)
On the Customization Projects (SM204505) form, import all customization projects that you need to upgrade for MYOB Acumatica 2026.1.1.
Start the publication of these customization projects. The system first validates the projects for compatibility with the current version.

If validation errors occur:

Learn what each error message means. (See Validation of Customization Projects: Compatibility Validation Errors.)
Check the developer release notes for descriptions of specific issues. You can find the release notes, along with the needed MYOB Acumatica build, on the Acumatica Community website.
Replace updated or deprecated objects with the recommended alternatives. You can use AI tools to simplify update. (See Validation of Customization Projects: Using AI Tools.)
Redesign solutions if no alternatives are available for removed objects.

During the Upgrade

In the production environment, do the following during the upgrade to MYOB Acumatica 2026.1.1:

Unpublish all customization projects. (See Unpublishing Customization Projects for details.)
Upgrade the MYOB Acumatica instance.
Replace the old customization projects with those validated for MYOB Acumatica 2026.1.1. (See To Replace the Content of a Project from a Package for more information.)
Publish the validated customization projects. (See Publishing Customization Projects for details.)

After the Database Upgrade

During the upgrade, the search index may become outdated. After upgrading the database, rebuild the search index:

Open the Rebuild Full-Text Entity Index (SM209500) form.
On the form toolbar, click Process All.

This process:

Rebuilds the content of the searchable DACs
Optimizes this content for fast query performance and stores it in the SearchIndex database table