Intellij SFCC installs like any JetBrains plugin. Afterwards, continue with Set Up Your Project
Before you start
| You need | Details |
|---|---|
| A supported IDE | IntelliJ IDEA, WebStorm, PhpStorm, Rider, RubyMine or RustRover, build 2026.1 or newer for this release. Older IDEs can use an older release from the Versions tab of the Marketplace listing |
| The bundled language plugins | JavaScript and TypeScript, CSS, Sass, JSON and Properties must be enabled (on by default) |
| JavaScript Debugger | Optional. Needed for the Script Debugger |
| A license or trial | Activated after the install, see Purchase & License |
Open the Plugins page
Plugins install from Settings › Plugins, which has a Marketplace and an Installed tab. Any of these routes gets you there:
| Route | macOS | Windows and Linux |
|---|---|---|
| Main toolbar | The gear (IDE and Project Settings) at the right end of the main toolbar › Plugins... | The same |
| Keyboard | ⌘, opens Settings, then click Plugins | Ctrl+Alt+S, then Plugins |
| Main menu | IntelliJ IDEA › Settings... (your IDE's name, such as WebStorm) in the macOS menu bar, then Plugins | File › Settings... (behind ☰ in the new UI), then Plugins |
| Welcome screen | With no project open, click Plugins on the left | Same |
| Find Action | ⇧⌘A, type plugins and select Plugins... | Ctrl+Shift+A, then the same |
Install from Marketplace
Find the plugin
On the Marketplace tab of the Plugins page, search for Salesforce B2C and select Salesforce B2C Commerce (SFCC), the Marketplace name of Intellij SFCC
Install and restart
Click Install, then Restart IDE when the download finishes, and confirm the restart
Activate the license
Open B2C Explorer on the right tool window bar. Without a license it shows "Plugin access is unavailable" and Check Activation, which opens the IDE's license dialog, see Purchase & License
More in the JetBrains plugin management guide
Install from disk
For an offline machine or a package your organization provides, download a compatible .zip from the Versions tab. On the Plugins page, click the gear next to the Marketplace and Installed tabs, not the one in the main toolbar, choose Install Plugin from Disk... and select the archive. Restart, then activate the license as above
What you see after installing
These appear in a project with SFCC code: cartridges on disk, a dw.json that names a host, or a connection. A project without any shows only Find New Cartridges and More, see Projects without SFCC code
| Where | What appears |
|---|---|
| Right side of the IDE | The B2C Explorer and B2C Credentials tool windows |
| Bottom of the IDE | B2C Sync Log, B2C ODS and B2C OCAPI |
| Main toolbar | Find New Cartridges and More. The connection, code version, deploy and upload buttons join them once a cartridge is linked and a connection is active |
| A few seconds after opening a project | Found N cartridges, if the plugin finds cartridges that aren't linked yet |
| Editor | Intellij SFCC: Getting Started, while the project's setup is unfinished, see Use Getting Started |
| Status bar | Setup 0/5, which opens Getting Started |
Every button and tool window is listed in Actions & Shortcuts
Coming from another SFCC plugin
Project files left by another SFCC plugin, such as Salesforce Commerce Cloud Studio, can cause an Unknown Module Type warning when the project opens, or a Debug button that stays disabled
Close the project
Choose File › Close Project
Move the .idea folder away
Move the project's .idea folder out of the project, for example to your desktop, so you can restore it
Open the project again
Open the project root. The IDE creates a fresh .idea, and the plugin offers to link your cartridges again
Accounts in B2C Credentials are kept, they live in the IDE. Connections, deploy settings and other project settings start empty, so add the connection again, see Where the plugin keeps its state
If something is missing
| What you see | What to do |
|---|---|
| There is no gear in the main toolbar | The main toolbar is hidden, customized or in the classic UI. Press ⌘, (Ctrl+Alt+S) and click Plugins |
| Marketplace shows no compatible version | Update the IDE, or install an older release from the Versions tab |
| The plugin is installed but disabled | Enable it in Settings › Plugins › Installed. If the IDE names a missing plugin, enable that one too |
| No B2C tool windows | Restart the IDE, open a project and look in View › Tool Windows |
When you contact support, include the IDE name and build, the plugin version and the exact message