SuiteCommerce Developer key terms
SuiteCommerce Developer · Get comfortable with the vocabulary.
- SuiteCommerce vs. Site Builder
- Related: Commerce Web Store, SuiteScript 2.1
SuiteCommerce is the e-commerce platform running on NetSuite records and SuiteScript; Site Builder is the legacy CMS-style storefront toolset. Knowing which features belong to each prevents choosing the wrong extension point during design questions.
- Commerce Web Store
- Related: SuiteCommerce vs. Site Builder, Domain and Hosting Setup
A NetSuite record that defines a SuiteCommerce web store: domains, tabs, categories, and configuration. It is the top-level container developers reference when scoping site-level settings and deployment targets.
- Domain and Hosting Setup
- Related: Commerce Web Store, CDN and Asset Caching
Configuration that maps a custom domain to a SuiteCommerce site, including DNS records, SSL certificates, and the NetSuite-hosted or externally hosted options. Errors here cause checkout and asset-loading failures that are not code bugs.
- CDN and Asset Caching
- Related: Domain and Hosting Setup, Extension Bundle
SuiteCommerce serves compiled frontend assets through a content delivery network with cache-busting based on build versions. Understanding caching explains why code changes appear stale until a new bundle is deployed or the cache is invalidated.
- SSP Application (ssp_libraries)
- Related: SuiteScript 2.1, Custom Service Endpoint
The SuiteCommerce service layer application that exposes RESTlets and services to the storefront, handling cart, checkout, and product data requests. Backend customizations often extend or wrap these services rather than editing frontend code.
- SuiteScript 2.1
- Related: User Event Script, RESTlet, Custom Service Endpoint
The JavaScript-based NetSuite scripting API used across SuiteCommerce backend customization, including user event, scheduled, RESTlet, and client scripts. Version choice affects module syntax, promises, and which APIs are available at runtime.
- User Event Script
- Related: SuiteScript 2.1, Record Types and Custom Fields
A server script that runs beforeLoad, beforeSubmit, and afterSubmit around record create, edit, or delete. In SuiteCommerce it commonly enforces pricing, inventory, or customer rules before data reaches the storefront.
- RESTlet
- Related: Custom Service Endpoint, SuiteScript 2.1
A SuiteScript entry point callable over HTTP that returns JSON or text. Storefront extensions use RESTlets to expose custom server logic when the standard SSP services do not cover a requirement.
- Custom Service Endpoint
- Related: SSP Application (ssp_libraries), RESTlet
A custom route added to the SuiteCommerce service layer so the frontend can call backend logic through the same request pipeline as built-in services. It keeps authentication, error handling, and caching consistent with platform behavior.
- Record Types and Custom Fields
- Related: User Event Script, Item and Matrix Items
NetSuite's data model of standard records such as items, customers, and sales orders, plus custom fields and custom records. SuiteCommerce reads this model directly, so field-level changes ripple into product detail and checkout behavior.
- Item and Matrix Items
- Related: Record Types and Custom Fields, Product Detail Page (PDP)
Items are sellable records; matrix items group child items by size, color, or other options. Storefront product pages, option selectors, and cart line generation all depend on how the matrix is configured.
- SuiteScript Deployment
- Related: User Event Script, Script Logging and Governance
A record that binds a script to a record type, event, or schedule and controls status, audience, and logging. Misconfigured deployments are a frequent cause of custom logic not firing in production.
- Script Logging and Governance
- Related: SuiteScript Deployment, Performance Profiling
NetSuite's execution limits and logging tools, including usage units, governance thresholds, and execution logs. Custom SuiteCommerce logic must stay within these limits because storefront requests run under the shopper's session.
- SuiteCommerce Extension
- Related: Extension Bundle, Extension Manager
A packaged customization containing frontend modules, templates, services, and configuration that is deployed to a site. Extensions are the supported way to add features without forking core source code.
- Extension Bundle
- Related: SuiteCommerce Extension, CDN and Asset Caching
The compiled, deployable artifact produced when an extension is built, including JavaScript modules, templates, and assets. Deployment activates the bundle on a site and is required before changes appear to shoppers.
- Extension Manager
- Related: SuiteCommerce Extension, Extension Bundle
A NetSuite record and toolset for installing, activating, and configuring extensions on a web store. It controls which extensions are available per site and per domain, which matters when managing multiple storefronts.
- Backbone.js Models and Views
- Related: JavaScript Module (AMD), Template Override
The frontend framework SuiteCommerce uses for models, collections, and views that bind data to templates. Customizing behavior usually means extending a view or overriding a method rather than editing HTML directly.
- JavaScript Module (AMD)
- Related: Backbone.js Models and Views, Dependencies and Entry Points
SuiteCommerce organizes frontend code as asynchronous modules with dependencies declared in define blocks. Correct dependency lists and module paths determine whether an extension loads and can inject into a page.
- Dependencies and Entry Points
- Related: JavaScript Module (AMD), Extension Bundle
The manifest-style configuration declaring which modules an extension depends on and where it hooks into the application. Wrong entry points are a common reason custom code compiles but never executes.
- Template Override
- Related: Handlebars Templates, Backbone.js Models and Views
Replacing or extending a Handlebars template used by a view so markup changes without editing core files. Overrides must match the data context the view passes or rendering breaks silently.
- Handlebars Templates
- Related: Template Override, Theme Skin
The templating language used to render SuiteCommerce pages, supporting helpers, partials, and context variables. Developers customize markup through templates and must understand escaping and context scope.
- Theme Skin
- Related: Template Override, Sass Compilation
A set of CSS, images, and template overrides that controls a site's visual appearance. Skins are applied per site and are the primary lever for branding without touching functional code.
- Sass Compilation
- Related: Theme Skin, Extension Bundle
SuiteCommerce styles are authored in Sass and compiled into CSS during the build. Variables and mixins in the theme control colors, spacing, and typography, so recompiling is required after style edits.
- Site Builder Themes
- Related: SuiteCommerce vs. Site Builder, Theme Skin
The legacy theme system for Site Builder storefronts, using HTML/CSS templates and content-managed pages. It differs from SuiteCommerce themes and is tested mainly to distinguish legacy capabilities from current ones.
- Content Delivery and CMS Pages
- Related: Site Builder Themes, URL Routing and SEO
Content types such as landing pages, categories, and tabs managed through the site's content tools. Understanding where content lives explains routing behavior and why some pages are not code-driven.
- URL Routing and SEO
- Related: Content Delivery and CMS Pages, Product Detail Page (PDP)
How SuiteCommerce builds product, category, and search URLs, including canonical tags, redirects, and friendly URL settings. Routing changes affect search rankings and must be coordinated with content and marketing.
- Product Detail Page (PDP)
- Related: Item and Matrix Items, Add-to-Cart Flow
The page rendering a single item, including options, pricing, images, availability, and add-to-cart controls. It is the most commonly customized page and depends on item data, templates, and views together.
- Add-to-Cart Flow
- Related: Product Detail Page (PDP), Cart and Checkout Modules
The sequence of frontend and backend calls that validates an item and adds it to the cart, including option checks and pricing. Customizations here often break quantity or matrix handling if validation is bypassed.
- Cart and Checkout Modules
- Related: Add-to-Cart Flow, SSP Application (ssp_libraries)
The frontend components and service calls that manage cart lines, promotions, shipping, and order submission. Checkout is heavily regulated and tightly coupled, so extensions should hook in rather than replace.
- Search and Facets
- Related: URL Routing and SEO, Product Detail Page (PDP)
The site search system that indexes items and exposes filters, sorting, and keyword results. Customizing facets or result ranking requires understanding both indexing configuration and frontend search views.
- Customer Center and Registration
- Related: Record Types and Custom Fields, Cart and Checkout Modules
The account area where shoppers register, log in, view orders, and manage profiles. Extensions touching authentication must respect session handling and the customer record model.
- Performance Profiling
- Related: Script Logging and Governance, CDN and Asset Caching
Measuring page load and request timing to find slow services, oversized assets, or excessive script calls. SuiteCommerce performance is sensitive to backend governance limits and frontend bundle size alike.
- Sandbox and Release Preview
- Related: SuiteCommerce Extension, SuiteScript Deployment
Non-production environments used to test customizations against upcoming NetSuite releases. Because platform updates can change APIs, validating extensions in a sandbox before production deployment is standard practice.
- Source Control and Build Pipeline
- Related: Extension Bundle, Dependencies and Entry Points
The workflow of versioning extension code and running the build that produces deployable bundles. A reproducible pipeline is essential because manual edits on a live site are overwritten by the next deployment.
- Translation and Localization
- Related: Theme Skin, Content Delivery and CMS Pages
Managing locale-specific strings, currencies, and content in the storefront. SuiteCommerce uses translation files and locale settings, and extensions must supply strings for every active language to avoid fallback text.
- Secure Secrets and Authentication
- Related: Custom Service Endpoint, Customer Center and Registration
Handling tokens, API credentials, and shopper sessions safely in scripts and services. Secrets belong in secure storage rather than frontend code, and service endpoints must validate caller identity.