Components of SSP Applications

This topic applies to

Applies to

SuiteCommerce | SuiteCommerce Advanced | Site Builder


To customize and create SSP applications successfully, it is important to understand the different components involved:

SuiteScript Server Pages Feature

To use SSP applications, enable the following features:

  • SuiteScript Server Pages - to create, view, or customize SSP applications.

  • SuiteScript 2 Server Pages - to use SuiteScript 2.0 in SSP applications. Note that SSP applications written in SuiteScript 1.0 will continue to work as normal when this feature is enabled.

For more information, see Enable Required Features for SuiteScript 1.0 SSP Applications and Enable Required Features for SuiteScript 2.0 SSP Applications.


You must have the SuiteScript permission to access SSP Application records. To set up permissions, go to Setup > Users/Roles > Manage Roles.

SSP Application Record

The SSP Application record provides a single NetSuite object that stores details about a website customization. This record facilitates grouping of assets, debugging of script files, and packaging of the customization for use in other NetSuite accounts. On this record, you can create and view the following properties:

SSP Application Precedence

When SSP applications share a URL and hosting root, a system of precedence determines which SSP application handles a particular request. For more information, see Change SSP Application Precedence.


SSP application precedence does not apply to SSP applications written in SuiteScript 2.0 because such applications cannot share both a URL and a hosting root. If two SSP applications written in SuiteScript 2.0 have the same URL root, they cannot be deployed to the same domain or website.

File Types for SSP Applications

Web store customizations implemented through SSP applications support the following file types:

  • .ssp files: These files, known as SuiteScript Server Pages, are frontend pages that can be written in HTML and/or server-side SuiteScript. They are similar to .jsp files, use a similar tag convention, and support Includes so that code can be pulled from associated libraries. You may invoke suitelets and RESTlets from .ssp files. Also, you can use .ssp files to develop pages that use JQuery.

  • .ss files: These files are request handlers written in SuiteScript, basically a specialized type of suitelets. They can be frontend non-HTML pages, such as AJAX handlers, or they can be backend pages that take an HTTP request and perform an action, such as writing HTML, XML, JSON or JavaScript to the output stream or issuing a redirect.

Both .ssp files and .ss files run against the server. These files support the full range of existing SuiteScript APIs that run on the server. SSP application files written in Suitescript 1.0 also support the Commerce API designed to support web store customizations.

For basic examples of .ssp and .ss file content, see Sample SSP Application Code (SuiteScript 1.0) and Sample SSP Application Code (SuiteScript 2.0).

Commerce API

The API, supported by both Site Builder and Commerce web stores, includes all of the web store-specific objects and related methods that you need to fully customize your web store on the SuiteCloud platform.

For details about this API, see Commerce API.


The Commerce API is not available for use with SSP applications written in SuiteScript 2.0.