Upgrading Your Managed Bundle Install Base

One of the issues that solution providers face is ensuring that users of their bundles apply updates as they become available. Managed bundles allow you to upgrade bundles in the accounts where they are installed whenever a new version is available.

Users who have installed a managed bundle do not have responsibility for updating it; the bundle author completes this task at their discretion. For managed bundles, only an administrator or a user with the SuiteBundler Upgrade Install Base permission can apply updates to the install base.

For information about managed bundle upgrades, see:


Support for managed bundle upgrades varies across the different types of NetSuite accounts. See Bundle Support Across Account Types.

Timing Managed Bundle Upgrades

With managed bundles, you can more carefully manage updates during the phased NetSuite release cycle when some of the accounts in your install base might be running a different version of NetSuite than your account. Managed bundles support a phased upgrade process that supports maintenance of multiple versions of a managed bundle. With phased upgrades, you can continue to push maintenance updates to accounts still using the older version of the bundle, during the time that other accounts are being upgraded to the new version. See Phased Upgrade of Managed Bundles.

You can use the Release Preview account to test updates to a managed bundle before you push updates to the production accounts for your install base. For more information about the Release Preview account, see Overview of Release Preview and Test Installed SuiteApps (Bundles).


You should not attempt to maintain more than two released versions of a managed bundle at any one time.

Canceling Pending Managed Bundle Upgrades

Typically a managed bundle upgrade is pushed to many target accounts at one time. If you discover an error before the upgrade is completed in all target accounts, you can stop the upgrade immediately. You do not have to wait for the upgrades to complete in all accounts and then start over. The Cancel Pending Upgrades button is available on the Initiate Upgrade page for managed bundles. You can click this button to cancel the upgrades in any target accounts that have a status of Pending.

Notifications for Managed Bundle Upgrades

SuiteBundler sends email notifications of successful managed bundle upgrades to target account users. For details, see Managed Bundle Upgrade Notifications to Target Account Users.

SuiteBundler also sends email notifications of managed bundle upgrades to bundle owners. After a managed bundle upgrade has ended, a summary email message containing details about the upgrade is sent to the user who initiated the upgrade. This message can also be sent to other users in the managed bundle’s source account. These additional recipients can be set in a new Email Recipients field that is available on the Bundle Details page in the source account.

This summary email has a subject of Summary of Managed Upgrade for Bundle <BundleID>. It includes the following details:

Steps for Managed Bundle Upgrades

Complete the following procedure to upgrade a managed bundle.

To upgrade a managed bundle:

  1. Go to Customization > SuiteBundler > Managed Bundles.

  2. Click Upgrade next to the bundle you want to install in other accounts.

  3. The Initiate Upgrade page shows the following:

    • the account number and name of each company that has installed your managed bundle

    • the version of NetSuite they are running

    • the version of the bundle installed in the account

    • the date of the installation


      The date value is hardcoded to Pacific Time Zone and does not reflect the time zone setting on Home > Set Preferences.

    • the date of the last upgrade


      The date value is hardcoded to Pacific Time Zone and does not reflect the time zone setting on Home > Set Preferences.

    You can filter the target accounts displayed on this page by region, bundle version, and NetSuite version. See Filtering on Bundle Install Base Lists and Filtering Managed Bundle Install Base by NetSuite Version.

  4. If you have deprecated the managed bundle to be upgraded, be aware of the following:

    • The Initiate Upgrade page for the deprecated version of a managed bundle lists only the accounts that have not yet been upgraded to the replacement version. This page can be used to push maintenance fixes to accounts with the lagging bundle version.

    • The Initiate Upgrade page for the replacement version of the bundle lists accounts with the deprecated version as well as accounts with the replacement version installed. This page can be used to upgrade accounts with the lagging bundle version to the newer version as well as push maintenance fixes to accounts that already have the newer version installed.

  5. Check the box in the Include column next to each account where you want to install the new version, or use Mark All and Unmark All to select accounts to upgrade.

  6. Click Upgrade.

    • After you have initiated the upgrade, the Bundle Install Base shows the status of the upgrade in each account in the Install Status column

    • At any time, you can click the Cancel Pending Upgrades button to prevent the upgrade of accounts with a status of Pending. When you click this button, a popup asks whether you are sure. When you confirm, a banner appears on the Initiate Upgrade page stating that cancellation of pending upgrades is in progress, until the cancellation is complete.


During an upgrade to a managed bundle, handling of data updates for custom lists, and for custom records that include data, depends on the option set for each of these objects on the Step 4 Set Preferences page of the Bundle Builder. The default is to preserve target account object data, but the bundle author can also choose an option to replace target account object data with bundled object data. See Bundle Object Preferences.


You can update a managed bundle in accounts that have installed it, but you cannot install a bundle in other accounts unless you have administrator access. For more information, see Pushing a Bundle to Other Accounts.

The user shown in the bundle audit trail as executing a managed bundle update in a target account is an arbitrary designation. The managed bundle update process selects a user in the target account employee list to be the entry in the Installed By column of the audit trail. This selection is the administrator that has the lowest internal ID.

After an upgrade of a managed bundle, the owner of the bundle is set to a random account administrator. This setting may not correspond to the administrator who originally installed the bundle. This behavior is by design and should not cause issues.

Related Topics

SuiteApp Creation and Distribution
Managed Bundles Overview
Managed Bundles - Best Practices
Pushing a Bundle to Other Accounts
Viewing Your Bundle Install Base
Phased Upgrade of Managed Bundles
Filtering Managed Bundle Install Base by NetSuite Version

General Notices