Newsletter Sign Up Using Core SCA Source Code

This topic applies to

Applies to

SuiteCommerce Advanced


The Newsletter extension works for SuiteCommerce sites and SuiteCommerce Advanced sites implementing the 2018.2 release and later. If you are incorporating SuiteCommerce Advanced Aconcagua and earlier, you must use the sign up form incorporated in the source template file, as described in this section.

Be aware of the following for these implementations:

  • The sign-up form leverages NetSuite’s elevated permissions feature to enable email subscriptions for your site.

  • Configuration properties are located on different tabs in the SuiteCommerce Configuration record, depending on your implementation. For more information, see Configure a Newsletter Sign Up Form.

Set Up Newsletter

SuiteCommerce Advanced releases Vinson, Elbrus, Kilimanjaro, and Aconcagua use elevated permissions that need to be set up manually.

  • Enable subscriptions

  • Create a custom center

  • Create a custom role

  • Set up elevated permissions for the service file record

To enable subscriptions:

  1. In NetSuite, go to Setup > Company > Enable Features > CRM tab.

  2. In the Basic Features section, check the Marketing Automation option. This enables the Global Subscription Status in Customer and Lead records.

  3. In the Marketing section, check the Subscription Categories and Sales Campaigns options. This enable these campaigns.

  4. Click Save.

To create a custom center:

  1. In NetSuite, go to Customization > Centers and Tabs > Centers > New.

  2. In the Label field, enter any string to label your new center.

    For example: Custom Employee Center.

  3. Click Save.

To create a custom role:

  1. In NetSuite, go to Setup > Users/Roles > Manage Roles > New.

  2. In the Name field, enter a name for your new custom role.

    For example: Custom Newsletter.

    You select this name when assigning elevated permissions in the Service File record.

  3. In the Center Type field, select the custom center you created earlier.

    For example: Custom Employee Center.

  4. If you are using NetSuite OneWorld, in the Subsidiary field, select the subsidiaries that are marked as default and online in the Website Setup record.

  5. Click the Permissions and Lists subtabs.

  6. Set the Level for the Customers permission to Edit.

  7. Click Save.

To set Elevated Permissions for the service file record:


The elevated permission is linked to the file. Therefore, you must set up the permissions for each deploy location (test site, production site, etc.) as necessary.

  1. In NetSuite, go to Documents > Files > File Cabinet.

  2. Browse to Web Site Hosting Files > Live Hosting Files > SSP Applications > [Applicable Bundle Folder] > Development > services.

  3. Click Edit next to the file.

  4. In the File record, check the Available without login option.

  5. Click the Permission subtab.

  6. Check the Enabled option.

  7. In the Execute as role field, choose the custom role you created earlier.

    For example: Custom Newsletter.

  8. Check the Run Script Without Login option.

  9. Click Save.

Disable the Newsletter Form

The Newsletter form is incorporated in the core source code of SuiteCommerce Advanced. You must edit the distro file to remove the form.

If you implement the Aconcagua version of SuiteCommerce Advanced and use the SuiteCommerce Newsletter Sign Up extension, you must first disable the Newsletter form. Otherwise, your site displays two sign up forms, one in your site’s footer and the new newsletter form you add using Site Management Tools.

To disable the Newsletter feature:

  1. Open the distro.json file in the root directory of the SuiteCommerce Advanced source code.

  2. Search for and remove or disable any lines that include Newsletter within the distro.json file, where x.x.x equals the version.

    For example:

    "suitecommerce/Newsletter": "x.x.x", "Newsletter.ServiceController", "Newsletter"
  3. Save and redeploy the distro.json file.