SuiteScript
Refer to the following sections for details on SuiteScript updates for NetSuite 2026.2:
SuiteScript 2.1 is the Standard Scripting Version
SuiteScript 2.1 is now the standard scripting version for new and existing NetSuite customizations. NetSuite is phasing out SuiteScript 1.0, SuiteScript 2.0, and 2.x versions over multiple releases. This transition affects all SuiteScript 1.0 scripts and scripts that use the @NApiVersion 2.0 or @NApiVersion 2.x annotation values.
To prepare for this change, review your existing custom scripts and plan to update them to SuiteScript 2.1 as soon as possible.
The planned transition includes the following milestones:
|
NetSuite Release |
Change |
|---|---|
|
2026.2 |
SuiteScript 2.1 becomes the standard scripting model for new and existing scripts. |
|
2027.1 |
SuiteScript 1.0 enters end-of-life support, covering critical issues only. Other problems will require you to convert the scripts to 2.1 first. |
|
2028.1 |
SuiteScript 1.0 scripts can no longer be deployed in new accounts but remain deployable in pre-existing accounts. SuiteScript 2.0/2.x scripts run as SuiteScript 2.1 by default. |
|
2028.2 |
All new and existing scripts must use SuiteScript 2.1. Legacy script versions will no longer run. |
To help prepare for the transition, consider the following:
-
Inventory scripts that use SuiteScript 1.0, SuiteScript 2.0, or
@NApiVersion 2.0or@NApiVersion 2.x. For more information, see Identifying Scripts That Are Not Using SuiteScript 2.1. -
Test existing SuiteScript 2.0 and 2.x server scripts by using the available company preferences to run them in the SuiteScript 2.1 runtime before updating the annotation. For more information, see Enabling SuiteScript 2.1 at the Account Level.
-
Prioritize updates for business-critical customizations.
For information about migration strategies, compatibility differences, the SuiteScript upgrade skill, and testing recommendations, see Transitioning To SuiteScript 2.1.