Deploy to a NetSuite Sandbox

This topic applies to

Applies to

SuiteCommerce | SuiteCommerce Advanced


Commerce web stores also enable you to deploy to a sandbox account. See the help topics NetSuite Sandbox and FAQ: NetSuite Sandbox for more information about sandbox accounts.


Before deploying to your sandbox account, you should verify that the Commerce bundles are installed. You may also need to delete the .nsdeploy file if you previously deployed to an account other than the sandbox account. Deleting this file enables you to enter the login credentials for the sandbox account.

To deploy to a sandbox account:

  1. Go to your command line or terminal window.

  2. Enter the appropriate command for your environment from the top-level directory of the source files (the same directory used during the tools installation).

    • Theme developer tools: gulp theme:deploy

    • Extension developer tools: gulp extension:deploy

    • Core SuiteCommerce Advanced developer tools: gulp deploy

    If this is the first time you are deploying, the tools create a sub directory called DeployDistribution. The tools then compile the source files and output them to this directory.


    Subsequent deployments only prompt for your NetSuite password. To reset the login information and enter information again, use the gulp deploy --to command to deploy your changes.

  3. When prompted, enter the email and password of your sandbox account.


    The developer tools do not support emails or passwords containing special characters such as + and %.

  4. When prompted, select the sandbox account where SuiteCommerce or SuiteCommerce Advanced is installed.

  5. When prompted, navigate to Web Site Hosting Files for your Commerce installation:

    • SuiteCommerce: Web Site Hosting Files > Live Hosting Files > SSP Applications > NetSuite Inc. - SCS

    • SuiteCommerce Advanced: Web Site Hosting Files > Live Hosting Files > SSP Applications > NetSuite Inc. - SCA <version> Development

After you enter your connection setting, the contents of the DeployDistribution folder on your local system are uploaded to the NetSuite file cabinet of your sandbox account. This process may take a few minutes. Wait for the process to complete before proceeding.