Installation

Install the VS Code extension, sign in, and check that you are ready to connect a sandbox

Install the extension first, then sign in to your Intellij SFCC account. You will connect your sandbox in the next guide.

Before you start

  • Use Visual Studio Code 1.105 or later for the current extension package.
  • Have the Intellij SFCC .vsix package from your organization's approved distribution or Intellij SFCC support.
  • Have access to the Intellij SFCC account that owns your license or has an assigned organization license.

You do not need a sandbox password to install the extension. Sandbox credentials are configured separately after installation.

Install the extension

Select the package

Open the Command Palette with Ctrl+Shift+P on Windows/Linux or Cmd+Shift+P on macOS. Run Extensions: Install from VSIX and select your .vsix file.

Confirm installation

Open Extensions, find Intellij SFCC under installed extensions, and confirm it is enabled. Reload VS Code if prompted.

Open your project

Use File → Open Folder to open your existing project root, including its cartridges. If VS Code asks about Workspace Trust, trust only a project whose source you know.

For help with VSIX installation itself, see the VS Code extension installation guide.

Sign in and check your license

Open the account panel

Select Intellij SFCC in the Activity Bar, then open Intellij SFCC Account and select Login. You can also run Intellij SFCC: Login to Intellij SFCC Account from the Command Palette.

Complete browser sign-in

Sign in using the account associated with your license, then return to VS Code. This is your Intellij SFCC account; your Business Manager credentials belong to the sandbox connection you will create next.

Check the account state

Confirm that the account panel recognizes your account and license. If you recently purchased a license or received a team assignment, select Sync License.

Ready for the next step

You should now see the Intellij SFCC views and find commands by typing Intellij SFCC in the Command Palette. A sandbox connection is not expected yet.

If installation does not complete

What you seeWhat to do
VS Code reports an incompatible versionUpdate VS Code, then install the package again.
The extension is installed but its views are missingConfirm it is enabled, open a project folder, and reload the window. Check whether the workspace is in Restricted Mode.
Browser sign-in completes but the account is missingReturn to VS Code and retry Login. Check that the browser is signing in to the intended account.
The account is correct but the license is missingSelect Sync License, then Open Dashboard to check the subscription or organization assignment.

If the issue persists, contact support with the extension version, VS Code version, and exact error message. Do not include passwords or tokens.

On this page