Upgrade from Version 2 to Version 3 of SMT

This topic applies to

Applies to

SuiteCommerce Web Stores | Site Management Tools | Kilimanjaro | Aconcagua

Upgrading from version 2 to version 3 of SMT is a multi-step process. These steps include:

  1. Install the SMT Core Content Types Bundle

  2. Migrate SMT Content required only when upgrading from version 2 to version 3 of SMT

  3. Deploy the Supported SCA Version to a Site

Some important benefits of upgrading from version 2 to version 3 of SMT include:

  • Version 3 provides you with some features that are not available in version 2. See SMT Versions for a list of features and version availability.

  • Content for SMT version 3 is stored as NetSuite Records. See CMS Records for SMT.

  • Content records for version 3 content are exposed to SuiteScript. See the help topic Website.


It is best practice to run only one version of Site Management Tools on a single site. For example, if you have a single site record with multiple domains, do not run version 2 of SMT on one domain and version 3 of SMT on the other domain. Both domains should run the same version of SMT.

Install the SMT Core Content Types Bundle

Version 3 of SMT requires installation of the SMT Core Content Types Bundle. This bundle creates the four SMT Core Content Types and their corresponding custom records in your NetSuite account. These content types include:

  • Text

  • Image

  • Merchandising Zone

  • HTML

The content types and their associated custom records are locked and cannot be edited or deleted. For information on the custom records and CMS Content Records, see CMS Records for SMT.

Install the SMT Core Content Types bundle as the first step in implementing or migrating to SMT version 3. The bundle ID is 190323.

See the help topic Installing a Bundle.

Migrate SMT Content

Content that you add to a site running version 2 of SMT is stored differently from content for version 3 of SMT. When you upgrade your site, such as migrating from a pre-Kilimanjaro release of SCA to Kilimanjaro or greater, the content on the site must be migrated from version 2 to version 3. Without this migration, content created with version 2 of SMT does not display on the site.


This process migrates only the published content on your site. If your SMT version 2 site has content that has not yet been published, you must publish the content before the content migration. If you have content that is not ready to be published, you must manually add it to your site after the migration.

Multiple Migrations

You can run the migration process multiple times. Each time you run the migration, previously migrated content is cleared and re-created from the version 2 content. You receive a warning about this during the migration. An example of when you could encounter this situation is if you run the migration, but then realize you have content that was not yet published. Since unpublished content is not migrated, you publish the content, and then run the migration again.


If you have upgraded your site to version 3 and then downgraded to version 2 and then upgraded to version 3 again, it is important that you run the migration again to migrate any new content that may have been added to your version 2 site.

To migrate content from SMT version 2 to version 3:

  1. Go to Lists > Web Site > CMS Contents.

  2. Click the CMS Content Migration button. This displays the CMS Content Migration page.

  3. Select the site you want to migrate from the Site dropdown list.

  4. Click the Begin Migration button.

    This displays a message that the migration deletes any Version 3 content. If you are migrating from version 2 to version 3 then there is no need to be alarmed by the message. You can run the migration multiple times, and each time it clears the previously migrated content and migrates it again from the content on the version 2 site.

  5. Click the OK button to begin the migration.

    It may take several minutes to complete the migration. You can click the Refresh button to monitor the status of the migration.

Deploy the Supported SCA Version to a Site

Site Management Tools version 3 is supported by the Kilimanjaro release of SuiteCommerce Advanced (SCA). If you are setting up a new site with the Kilimanjaro release of SCA, then follow the normal procedure for implementing an SCA site. See Install Your SuiteCommerce Application. If your site currently runs on a pre-Kilimanjaro release of SCA, then you must migrate to Kilimanjaro. See Migrate SuiteCommerce Advanced to the Latest Release.