Tips and Tricks while updating bundle
In NetSuite, the PRESERVE DATA / REPLACE DATA / MERGE DATA preference appears on the Preview Bundle Update page when the bundle contains:
- Custom Lists
- Custom Records (with Include Data enabled)
It is available during bundle installation as well, for applicable objects. For bundle updates, it applies to objects being updated and conflicting objects where Replace Existing Object is selected.
Meaning of each option
Preference | What happens |
|---|
PRESERVE DATA | Keeps existing data in the target account without changing it. |
REPLACE DATA | Replaces existing target-account data with data from the bundle source account. |
MERGE DATA | Combines source and target data. Existing target-only entries are retained, while bundle entries are added or updated. |
Which option should we select?
For a Production bundle update, Recommended default PRESERVE DATA
Object | Suggested preference | Reason |
|---|
Custom Lists | Preserve Data | Avoid removing existing Production list values. |
Custom Records | Preserve Data | Protect existing Production configuration and records. |
When to use the other options:
- REPLACE DATA: When Production must exactly match the source bundle data and replacing existing entries is intentional.
- MERGE DATA: When you want new bundle entries while retaining additional Production entries.
Example
Suppose your custom list contains the following values:
Sandbox (Bundle Source) | Production (Target) |
|---|
India | India |
Singapore | Singapore |
USA | USA |
| Malaysia |
After the bundle update:
Preference | Production result |
|---|
Preserve Data | Existing Production values remain unchanged. |
Replace Data | India, Singapore, USA |
Merge Data | India, Singapore, USA, Malaysia |
In NetSuite, the REPLACE EXISTING OBJECT option appears when you install or update a SuiteBundle and NetSuite identifies that an object already exists in the target account.
You generally see this option during the Bundle Update / Preview process, before confirming the update.
For example, if Bundle current version contains a script, custom field, saved search, or custom record that already exists in your account, NetSuite may ask how to handle that existing object.
When does NetSuite show this option?
You will see it when:
- You click Update against the installed bundle.
- NetSuite opens the Preview Bundle Update page.
- A new or modified bundle object conflicts with an existing object in your account.
- The conflicting object appears in red, and the Action column provides a dropdown.
Should we select it for all objects?
The selection depends on the object.
Situation | Recommended action |
|---|
Same object exists in the target account and should be updated from the bundle | Replace Existing Object |
Existing object is unrelated or customized separately | Add and Rename |
No conflict exists | NetSuite handles Add/Update automatically |