Digital Script

Digital Script is the server script language of Salesforce B2C Commerce: JavaScript that Rhino runs, with importPackage, importClass and importScript, for each loops, E4X and type annotations. Intellij SFCC makes it a native IDE language, so .ds files and the server .js files of your cartridges get the syntax, scope and checks the server applies

Pick a modeNot set

STstorefrontSandbox 01version2

Totals.ds

1importPackage(dw.order);

2

3function label(basket : Basket) : String {

4 var total = basket.totalGrossPrice.value;

5 return `Total: ${total}`;

6}

Compatibility mode 21.2 does not support template literals (22.7 or later)Convert to string concatenation⌥⇧↩

Settings

Appearance & BehaviorKeymapEditorPluginsVersion ControlBuild, Execution, DeploymentLanguages & FrameworksDigital ScriptISMLJavaScriptNode.jsSchemas and DTDsSFCC Route CallsStyle SheetsTypeScriptTools

Languages & FrameworksDigital Script

Runtime

Script compatibility mode:21.2Not set22.721.219.1018.1018.2

The compatibility mode of the site's code version, in Business Manager under Administration > Site Development > Code Deployment. Script syntax that mode does not support is an error in .ds files, server .js files, ${...} and <isscript>. Not set uses 22.7, the mode of the code version last activated from the B2C explorer.

Server JavaScript

Parse cartridge .js as Digital Script

Server scripts below a cartridge folder accept the Rhino forms B2C Commerce runs, such as for each (var item in items). Client code in client, static and js folders stays JavaScript. .ds files are always Digital Script.

Imports

Optimize imports on the fly

Removes unused and repeated importPackage, importClass and importScript calls from .ds and server .js files as you edit. Not while the caret is on an import call or the file has errors, and only in files you changed. Code | Optimize Imports removes them in any file.

CancelApplyOK

storefrontapp_customcartridgescriptscartTotals.dsGlobal scopeLFUTF-8

Explore Digital Script

Which files are Digital Script

The client folders count only right under cartridge, so cartridge/scripts/js is still server code

The first start after the update moves *.ds from the JavaScript file type to Digital Script, once. If you map .ds back to JavaScript later, the IDE keeps your choice

require paths, module.superModule and custom attributes work in .ds files as in server .js files, see JavaScript

Settings

Options are in Settings › Languages & Frameworks › Digital Script. Project options are saved in .idea/intellij-sfcc-script.xml, so the team can share them

Script compatibility mode moved here from the ISML page. One mode covers templates, .ds and server .js files. A mode picked on the ISML page before 2026.3 counts until you pick one here, and the ISML page now shows the mode with a Change on the Digital Script page link

The other Digital Script options sit with their features:

Free and licensed

A license change applies at once, without a restart:

See Purchase & License for the trial

Works while the IDE indexes

Parsing, highlighting, folding, the compatibility mode check and the Rhino syntax checks work while the IDE indexes. importScript targets, imported names and the checks that read other files answer once indexing ends. Until then, Name that nothing declares leaves unresolved names to the IDE's own warning

From the plugin's performance tests:

The plugin parses all 199 SiteGenesis scripts and 207 SFRA server scripts without a parse error

What isn't covered

• Expression closures, legacy generators, let blocks and array comprehensions don't parse yet
• After importScript, static properties of an imported function, such as ResourceHelper.getConstants(), don't resolve
• Job step parameters stays Object: the parameter definitions in steptypes.json aren't read, and the dw.system.Status return isn't checked
• The Pipeline Editor reads dictionary rows only from .ds scripts, and doesn't show the header descriptions
• Call Hierarchy doesn't list top-level calls in template code, and Analyze Data Flow isn't available

Troubleshooting

Related