Configuration

Sandbox Connection

The VS Code extension manages connections through the dedicated sidebar panel.

Adding a Connection

Open the SFCC Panel

Click the Intellij SFCC icon in the Activity Bar to open the sidebar panel.

Add New Connection

Click the + button in the Connections section. A form opens in the editor.

Enter Credentials

Fill in your sandbox details:

Field	Description	Example
Name	A friendly name for this connection	`Dev Sandbox`
Hostname	Your sandbox hostname	`dev01-na01-example.demandware.net`
Username	Business Manager username	`admin`
Password	Business Manager password	`••••••••`
Code Version	Active code version	`version1`

Test Connection

Click Test Connection to verify your credentials. A green checkmark indicates success.

Credentials are stored in VS Code's SecretStorage API, which uses the OS keychain for security.

Multiple Connections

You can configure multiple sandbox connections and switch between them:

Click the connection name in the Status Bar to switch
Right-click a connection in the sidebar to set it as active
Each connection maintains its own code version and upload state

Extension Settings

General Settings

Access settings via Settings → Extensions → Intellij SFCC or add to settings.json:

{
  "intellijsfcc.upload.onSave": true,
  "intellijsfcc.upload.delay": 300,
  "intellijsfcc.upload.showNotifications": true,
  "intellijsfcc.upload.excludePatterns": [
    "node_modules/**",
    ".git/**"
  ]
}

All Settings Reference

Setting	Default	Description
`upload.onSave`	`true`	Upload files automatically on save
`upload.delay`	`300`	Debounce delay in ms before upload
`upload.showNotifications`	`true`	Show toast after each upload
`upload.excludePatterns`	`[]`	Glob patterns to exclude
`upload.cartridgePath`	`auto`	Override cartridge path detection

Setting	Default	Description
`isml.validation.enabled`	`true`	Enable ISML diagnostics
`isml.formatting.enabled`	`true`	Enable ISML formatting
`isml.completion.enabled`	`true`	Enable ISML completions
`isml.highlighting.customTags`	`true`	Highlight custom tags

Setting	Default	Description
`script.completion.dwApi`	`true`	DW API autocomplete
`script.completion.requirePaths`	`true`	Resolve require paths
`script.hooks.navigation`	`true`	Hook navigation
`script.hooks.completion`	`true`	Hook name completion

dw.json Configuration

The extension reads project settings from dw.json in your project root:

{
  "hostname": "dev01-na01-example.demandware.net",
  "username": "admin",
  "password": "password",
  "code-version": "version1",
  "cartridge-path": "app_custom:app_storefront_base"
}

If both dw.json and a sidebar connection are configured, the sidebar connection takes priority. You can override this in settings.

Keyboard Shortcuts

Default keyboard shortcuts (customizable in Keyboard Shortcuts):

Command	Windows/Linux	macOS
Upload Current File	`Ctrl+Shift+U`	`Cmd+Shift+U`
Upload Cartridge	`Ctrl+Shift+Alt+U`	`Cmd+Shift+Alt+U`
Toggle Log Streaming	`Ctrl+Shift+L`	`Cmd+Shift+L`
Switch Connection	`Ctrl+Shift+C`	`Cmd+Shift+C`
Open Sandbox in Browser	`Ctrl+Shift+B`	`Cmd+Shift+B`

On this page