You may have been a NetSuite User for a few years or even more than a decade now.

Your NetSuite Account must have undergone lots of changes.

You must have implemented a bunch of customizations, making the list of the scripts deployed in your account a long one.

But are you sure that your NetSuite account is using the latest version of SuiteScript?

For someone who is admittedly “non-technical”, this may not mean a thing. You might think that this is nothing to be worried about.

This guide is to give you facts about the script versioning and why it’s important to convert your scripts as early as possible.

How do I know if my scripts are still in SuiteScript 1.0 version?

  1. If you’re using an Administrator role, navigate to Customization > Scripting > Scripts.
  2. Filter the API version to 1.0.
  3. See the list of your scripts and you’ll see how MUCH work you need to do.

Well, it’s working! Why should I bother making the switch?!

Simple. There’s just so much features that you’re missing out on.

There are available script functionalities that are not accessible in SuiteScript 1.0. There is what we call the “Search Pagination API” that allows you to manipulate search results through pages, making it faster and more efficient. There’s also the ability to gather saved search results and save it to a CSV file. There’s even an available module called N/transaction that easily allows you to void transactions. Find more of these in this Help Guide document.

How can you prove that some features are not available in 1.0?

Well, this is not just me saying it. An official statement has been released by NetSuite explaining that they are not enhancing SuiteScript 1.0 anymore. This means that when your existing script needs to utilize a feature available in 2.0 version, it just isn’t possible with your current script in 1.0 version. You can see the statement on the Help Guide:

Use SuiteScript 2.0 for new scripts that you develop, and consider converting your SuiteScript 1.0 scripts to SuiteScript 2.0. SuiteScript 1.0 is no longer being updated, and no new feature development or enhancement work is being done for this version. SuiteScript 1.0 scripts continue to be supported, but you should use SuiteScript 2.0 for any new or substantially revised scripts to take advantage of new features, APIs, and functionality enhancements.

And if you’re an avid reader of the NetSuite Release Notes, you would notice that in these past few releases, they’re no more introducing new features for SuiteScript 1.0.

Okay, what else?

See this article NetSuite Development: Why you should start learning SuiteScript 2.0 and go to Item # 5. There is a possibility, though no official announcements have been made, that SuiteScript 1.0 will become deprecated in the coming years.

This would mean that if ever that time comes, your long list of SuiteScript 1.0 scripts will no longer be supported by NetSuite should it stop working. You’ll have to incur the efforts of switching it.

How do I start the conversion?

If you have an internal NetSuite Developer in your company, then the preparation will be less of a hassle for you. You can set up a meeting to discuss this initiative, and tackle the automated / customized processes in your NetSuite account that are critical to the daily operations.

There’s just SO MUCH to convert, what do you suggest?

This is the most important part of the project. How do you decide which scripts to be converted and which shouldn’t be?

This is where you or your trusted NetSuite Point of Contact comes in.  You have to plot down the most critical processes happening in your NetSuite Account and identify if they were customized or not.

After listing down the critical processes, assess which among the scripts need converting to avail the benefits of the new version. (We can also help you in this stage.) The benefits can be any of these: 1) faster performance, 2) script efficiency, 3) improved user experience, 4) enhanced security or 5) a goal for a major script refactoring.

Can you provide a sample script that needs converting?

If you have a Scheduled Script that’s using the old model of breaking down data by putting on multiple deployments, then you can have it converted to Map/Reduce script. Map/Reduce script allows the developer to have a flexibility of breaking down data processing within the script logic itself. This also handles governance issues that are normally encountered in Scheduled Scripts.

If you’re someone who is particular with how User Interface looks, you can also see if you’re interested to make use of the much more elegant NetSuite “dialog boxes”. See the differences below:

Old Dialog Box
NetSuite’s new Dialog Box design

What if I don’t have an internal NetSuite Developer in my company?

If you don’t have a NetSuite Developer yet, then you can hire a NetSuite Consulting firm to do this for you.

Here at LEACC CONSULTING, converting older versioned script to the latest version is one of the services we provide. Our team has been using SuiteScript 2.0 since its release. With our proven SuiteScript 2.0 expertise, you wouldn’t have a worry a thing or two about the conversion!


LEACC Consulting is a team of NetSuite Certified Developers with IT experience solely dedicated to NetSuite technologies for eight years. We are experts in both SuiteScript 2.0 and SuiteScript 1.0. Our team has worked with 400+ NetSuite scripts and workflows combined.


Leave a Reply