Book a Free Consultation

NetSuite 2028.2 confirmed deadline

Oracle NetSuite has confirmed that scripts using SuiteScript 1.0, 2.0, or 2.x will stop working in the 2028.2 release. NetSuite is displaying this warning at the account level now.

NetSuite

SuiteScript Deprecation Warning: Your account contains scripts using SuiteScript 1.0, 2.0, or 2.x. These script versions will stop working in NetSuite 2028.2. Action is required before the upgrade.

The account-level warning NetSuite displays on affected accounts.

SuiteScript Migration and Conversion Services

Your Legacy SuiteScripts Will Stop Working in NetSuite 2028.2

NetSuite has confirmed that scripts using SuiteScript 1.0, 2.0, or 2.x will stop working in the 2028.2 release. SuitePacific identifies affected scripts, converts them to SuiteScript 2.1, tests critical business processes in sandbox, and safely deploys the updated scripts before the deadline.

Not sure how many scripts are affected? Start with a free initial check. No obligation.

Quick answer

SuiteScript 1.0, 2.0, and 2.x scripts will stop working in NetSuite 2028.2. Oracle NetSuite has confirmed this deadline and is displaying an account-level warning on affected accounts. SuitePacific performs the complete migration: a script inventory that identifies every legacy script and deployment; a risk classification that assigns each script a business-impact tier; a compatibility review covering APIs, modules, shared libraries, and JavaScript differences; conversion to SuiteScript 2.1; sandbox testing across all entry points and business-critical scenarios; and production deployment with a rollback plan. SuiteScript 1.0 scripts require a full rewrite because the nlapiXxx API does not exist in 2.1. SuiteScript 2.0 and 2.x scripts require updating the version declaration and remediating strict mode issues. Third-party and bundled scripts require coordination with the script owner before any changes are made. Plans start at $799 per month on month-to-month terms after a three-month minimum.

Which NetSuite accounts are affected by the 2028.2 deadline?

Any NetSuite account with active scripts using SuiteScript 1.0, 2.0, or 2.x is affected. This includes accounts that have been live for several years and may contain scripts created by previous implementation partners, former employees, independent developers, or SuiteApp providers.

Many NetSuite administrators may not know how many legacy scripts exist in their account, which scripts are still being used, which business processes depend on them, or whether shared library files are being referenced by multiple scripts. The first step is a complete inventory.

You may have inherited scripts you did not build

Scripts from past go-live projects, third-party integrations, or previous support partners may still be active in your account and may not appear obvious in the script list. An audit will surface the full picture before the 2028.2 deadline creates an emergency.

What business processes could stop working after 2028.2?

The operational risk depends on which scripts are present and what they control. Legacy scripts often support core transaction workflows that teams depend on every day. If those scripts stop executing, the affected processes stop working with them.

  • Sales order processing and approval routing
  • Purchase order approvals and vendor workflows
  • Item fulfillment and warehouse operations
  • Invoice generation and billing automation
  • Revenue recognition and deferred revenue schedules
  • Inventory management and stock level monitoring
  • Customer and vendor integration via RESTlets
  • Nightly and weekly scheduled batch processes
  • Email notifications and alert systems
  • Custom forms, Suitelets, and portals
  • Financial reporting and GL posting logic
  • Map/Reduce processing for high-volume data

SuiteScript version comparison: what is the migration effort for each version?

The work required differs significantly between SuiteScript 1.0 and 2.0/2.x. All three legacy versions are affected by the 2028.2 deadline.

Version2028.2 statusMigration effort
SuiteScript 1.0 Stops working 2028.2Full rewrite required
SuiteScript 2.0 Stops working 2028.2Version update plus strict mode fixes
SuiteScript 2.x Stops working 2028.2Version update plus compatibility review
SuiteScript 2.1 Supported indefinitelyMigration target

Third-party scripts distributed through managed SuiteApp bundles must be updated by the SuiteApp provider. We identify these during the audit and advise on what to request from the provider.

Our SuiteScript 2.1 migration services: six stages from audit to deployment

A complete SuiteScript migration is not just a code change. It is a structured process that starts with understanding what exists in the account and ends with confirmed production behavior after deployment.

01

Script inventory

We identify every script configured with SuiteScript 1.0, 2.0, or 2.x in the account. The inventory includes script name, script ID, type, API version, file location, deployment status, active deployments, related records, shared library dependencies, bundle or SuiteApp association, and execution frequency. We also identify inactive or duplicate scripts that may not require conversion.

02

Risk classification

Each script is classified by business impact and migration complexity: Critical, High, Medium, Low, Inactive, Third-party managed, or Requires further investigation. Critical scripts include those supporting order processing, billing, fulfillment, financial posting, integrations, or high-volume scheduled jobs. The classification determines conversion priority and helps allocate time to the highest-risk work first.

03

Dependency and compatibility review

We review each affected script for features and behavior that may not work correctly under SuiteScript 2.1. This includes SuiteScript 1.0 APIs, 2.0 module patterns, shared library files, global variables, JavaScript syntax differences, date and time handling, error handling, search behavior, record handling, sublist processing, governance usage, promise behavior, and integration calls. Changing the version declaration alone is not a complete migration.

04

SuiteScript 2.1 conversion

We convert affected scripts to SuiteScript 2.1. For SuiteScript 1.0 scripts, this means a full rewrite replacing every nlapiXxx call with N/ module equivalents while preserving the existing business logic. For 2.0 and 2.x scripts, this means updating the version declaration and remediating strict mode incompatibilities. Material changes are documented. If we find serious technical debt, we report it separately so you can decide whether to address it during or after the migration.

05

Sandbox testing

Every converted script is tested in a NetSuite sandbox before production deployment. Testing covers script execution, entry points, record creation and editing, approvals, scheduled processes, Map/Reduce stages, Suitelet pages, RESTlet requests, client-side behavior, email notifications, saved search dependencies, workflow interactions, permissions, error logs, and high-volume processing. Where possible, business users confirm the processes they own before production go-live.

06

Production deployment and monitoring

Converted scripts are deployed to production through a controlled release process with a defined deployment order, a production backup, a rollback approach, a deployment timing plan, smoke testing, and business-owner confirmation. Error logs are monitored after deployment. You receive a final migration report showing what was reviewed, converted, tested, deployed, excluded, or assigned to a third-party provider.

Common SuiteScript 2.1 compatibility issues found during the audit

Changing the version header is not enough. These are the incompatibilities most frequently found in legacy scripts during the review phase. Some cause immediate failures; others fail only under specific transaction conditions.

SuiteScript 1.0 nlapiXxx calls

Every nlapiXxx function (nlapiLoadRecord, nlapiSearchRecord, nlapiSubmitField) must be replaced. These functions do not exist in 2.1.

Undeclared variables

SuiteScript 2.1 enforces strict mode. Variables used without var, let, or const throw a ReferenceError. Common in legacy 2.0 scripts.

Date and time handling differences

Date parsing differences appear in scripts that construct dates from string concatenation or rely on implicit timezone behavior.

Deprecated JavaScript patterns

arguments.callee, arguments.caller, and the with statement are forbidden in strict mode. These are present in some legacy 1.0 scripts.

Duplicate object properties

Object literals with duplicate property names are a syntax error in strict mode. Tolerated in ES3/ES5 but fail at parse time in 2.1.

Shared library incompatibilities

A single shared library file used by multiple scripts can affect the entire account if it contains incompatible patterns.

What you receive from the SuiteScript migration engagement

Every migration engagement produces concrete outputs. You should not complete the migration without a documented record of what was reviewed, converted, tested, and deployed.

  • Complete script inventory with version, type, and deployment data
  • Version and deployment report for all legacy scripts
  • Business-risk classification (Critical, High, Medium, Low, Inactive, Third-party)
  • Dependency map showing shared libraries and script interdependencies
  • Migration estimate with effort and timeline by script tier
  • Recommended priority order for conversion
  • Converted SuiteScript 2.1 files with documented changes
  • Sandbox test results across all entry points and business scenarios
  • Production deployment plan with rollback approach
  • Final migration report showing all outcomes and any excluded scripts

Why SuitePacific for SuiteScript 2.1 migration

The SuiteScript migration specialist for NetSuite accounts that cannot afford a failed upgrade.

SuitePacific is a boutique NetSuite consulting firm focused exclusively on post-go-live SuiteScript development and account support. Script audits, 1.0 rewrites, and 2.0-to-2.1 conversions are core work. Every script we convert is documented, tested in sandbox, and deployed to production with post-deployment monitoring.

  • + Oracle NetSuite SuiteCloud Developer II certified
  • + Oracle NetSuite Administrator Professional certified
  • + More than six years of SuiteScript development experience
  • + Experience across User Event, Client, Scheduled, Map/Reduce, Suitelet, RESTlet, and Workflow Action scripts
  • + Every 1.0 conversion starts with documenting the business logic before the rewrite begins
  • + Sandbox-first delivery on every conversion
  • + Direct access to the developer performing the conversion
  • + US-based LLC serving NetSuite customers internationally
  • + Month-to-month after a three-month minimum, starting at $799/month

How to get started with a SuiteScript 2.1 migration

  1. 1

    Request a free readiness check

    Tell us what you know about your scripts and whether the NetSuite warning is visible. We will discuss your situation and recommend the appropriate next step.

  2. 2

    Grant controlled NetSuite access

    We use a read-only or limited-access role during the audit phase to inventory scripts and deployments without making changes to the account.

  3. 3

    Receive the script inventory and risk report

    You receive a complete inventory, version breakdown, business-risk classification, dependency map, and a recommended priority order with a migration estimate.

  4. 4

    Approve the migration scope

    We agree on the conversion scope, starting version tier, timeline, and monthly hours before any code changes are made.

  5. 5

    Convert and test in sandbox

    Conversion work happens in the sandbox environment. You and your business users confirm processes before any production changes are scheduled.

  6. 6

    Deploy safely to production

    Production deployment follows a controlled plan with timing, smoke testing, business-owner confirmation, and post-deployment monitoring.

Not sure where your account stands?

Use the ten-question readiness checklist to identify gaps in your script inventory, process mapping, and sandbox readiness before the 2028.2 deadline.

Review the SuiteScript 2028.2 readiness checklist

Free SuiteScript 2.1 Readiness Check

Not Sure Where to Start? Start With a Free Check.

Tell us about your account and we will review your situation, discuss the scope of what needs to change, and explain what the migration involves. No obligation before we discuss.

No obligation. We will discuss your situation before requesting any account access.

SuiteCloud Developer II certified

NetSuite Administrator certified

Sandbox-first delivery

Direct access to the developer

Related reading

Frequently Asked Questions

When will SuiteScript 1.0 stop working in NetSuite?

Oracle NetSuite has confirmed that SuiteScript 1.0 scripts will stop working in the 2028.2 release. NetSuite is displaying an account-level warning on affected accounts now. Customers should start the audit and conversion process well before the 2028.2 upgrade window to avoid business process failures.

When will SuiteScript 2.0 stop working?

SuiteScript 2.0 scripts will stop working in the NetSuite 2028.2 release alongside SuiteScript 1.0 and 2.x scripts. Many accounts contain a mix of 1.0, 2.0, and 2.x scripts. The audit should identify all three versions so the full migration scope is clear before conversion begins.

Will SuiteScript 2.x scripts stop working in 2028.2?

Yes. Scripts configured with the 2.x version declaration will stop working in the 2028.2 release. Scripts must be explicitly updated to 2.1 and tested for strict mode compatibility. The 2.x declaration was intended as a forward-compatibility marker; it does not provide automatic compatibility with 2.1.

What is the NetSuite 2028.2 SuiteScript deadline?

NetSuite 2028.2 is the release in which Oracle plans to retire SuiteScript 1.0, 2.0, and 2.x. Scripts running on those versions will stop executing after the upgrade. Customers need to complete a script inventory, convert affected scripts to SuiteScript 2.1, test in sandbox, and deploy to production before the 2028.2 upgrade window.

How do I find SuiteScript 1.0, 2.0, and 2.x scripts in NetSuite?

Legacy scripts can be identified through the Script list at Customization > Scripting > Scripts. The API Version column shows which version each script uses. However, this list does not show library files, inactive scripts, or scripts installed through bundles and SuiteApps. A thorough audit requires checking script files, library files, and deployment records to build a complete picture.

Can SuiteScript 1.0 be automatically converted to 2.1?

No. SuiteScript 1.0 uses a completely different API structure (global nlapiXxx functions) that has no direct equivalent in 2.1. Every 1.0 script requires a full rewrite using the N/ module system. Automated tools cannot reliably translate business logic between the two APIs. The conversion must be performed by a developer who understands both what the original script does and how to replicate that behavior in 2.1.

Is changing the @NApiVersion header to 2.1 enough?

No. Changing the version declaration to 2.1 tells NetSuite to run the script under the 2.1 runtime, but it does not fix incompatible code. SuiteScript 2.1 enforces strict mode, which means undeclared variables, deprecated patterns, and certain object literal forms that worked under 2.0 will throw errors under 2.1. Every script must be reviewed and tested after the version declaration is updated.

What is the difference between SuiteScript 2.0 and 2.1?

SuiteScript 2.0 and 2.1 use the same N/ module system and the same API calls. The primary difference is that 2.1 enforces JavaScript strict mode, supports ES6+ syntax (arrow functions, template literals, destructuring, let and const), and disables features forbidden in strict mode. Well-written 2.0 scripts with clean code migrate quickly. Scripts with accumulated technical debt may require additional remediation.

How long does a SuiteScript migration take?

A single 2.0 script with no strict mode issues can be updated in hours. A full account migration covering a mixed inventory of 1.0, 2.0, and 2.x scripts across all script types typically takes weeks to months depending on script count, complexity, and the presence of undocumented 1.0 logic. The audit phase produces an accurate timeline before conversion begins.

How much does SuiteScript 2.1 migration cost?

Migration is available as part of a monthly retainer starting at $799 per month with a three-month minimum followed by month-to-month terms. The audit phase clarifies the conversion scope and produces an estimate before work begins. Larger or more complex inventories require more hours; the monthly plan determines how quickly the work is completed.

Can you migrate scripts created by another developer?

Yes. We work with scripts created by any developer, former employee, implementation partner, or independent contractor. Undocumented scripts require additional review to understand the business logic before the rewrite begins. We document the original logic as part of the migration process so the converted script can be maintained going forward.

Can you review scripts installed through bundles or SuiteApps?

We can identify bundle and SuiteApp scripts during the audit and flag their version status. However, scripts distributed through managed SuiteApp bundles must be updated by the SuiteApp provider. We identify which scripts fall into this category and provide guidance on what to request from the provider.

Will migration change our current business processes?

The objective of the migration is to preserve existing business processes while making scripts compatible with SuiteScript 2.1. We do not redesign functionality unless there is a specific technical reason or the customer requests an improvement. Material changes are documented. If we find unsafe or outdated logic that could cause problems, we report it separately and let you decide whether to address it during or after the migration.

Do you test converted scripts in sandbox before production?

Yes. Every converted script is tested in a NetSuite sandbox environment before production deployment. Sandbox testing covers all entry points, record types, approval workflows, scheduled processes, and business-critical scenarios. We also work with business users on user acceptance testing for the processes they own before the production deployment.

Can SuitePacific migrate only our critical scripts first?

Yes. The risk classification phase assigns each script a business-impact tier. We can prioritize Critical and High scripts and complete those before addressing lower-priority scripts. This approach reduces immediate risk while spreading the migration across retainer months at a manageable pace.

What happens if we do not migrate before NetSuite 2028.2?

Scripts that have not been converted to SuiteScript 2.1 will stop executing after the 2028.2 upgrade. Depending on what each script controls, the impact could include failed order saves, blocked approvals, stopped batch processes, failed integrations, missing field values, broken Suitelets, or failed scheduled jobs. Discovering these failures after the upgrade is significantly more disruptive than completing the migration beforehand.

Free SuiteScript 2.1 Readiness Check

Start Before the 2028.2 Deadline Becomes an Emergency

Accounts that begin the audit in 2026 or 2027 complete the work on a planned schedule. Accounts that start in 2028 are under deadline pressure. Request a free initial check and we will review your situation within one business day.

No obligation. We will discuss your situation before requesting any account access.

Last updated September 2026