Cartridge Management
Visual cartridge path management and overlay detection
The cartridge management system gives you full visibility into your SFCC cartridge overlay - see which cartridge provides each file, detect overrides, and manage your cartridge path visually.
Cartridge Path Visualization
The plugin displays your active cartridge path in a dedicated tool window:
Open the Cartridge Panel
Go to View → Tool Windows → Intellij SFCC Cartridges or click the cartridge icon in the sidebar.
View the Overlay
See all cartridges in priority order. Files that override base cartridge files are highlighted.
Navigate Overrides
Click any file to jump to it. Right-click to see all versions across the cartridge overlay.
Override Detection
When editing a file that exists in multiple cartridges, the plugin shows:
- A gutter icon indicating the file is overridden or overrides another
- A breadcrumb showing which cartridge the current file belongs to
- Quick navigation to the base or overriding version
Override detection works for controllers, templates, scripts, static files, and resource bundles.
Cartridge Path Editor
Edit your cartridge path directly from the IDE:
Use the visual cartridge path editor to reorder cartridges by dragging them. Changes are written back to your dw.json or synced to Business Manager.
Edit the cartridge path as a colon-separated string in dw.json:
{
"cartridge-path": "app_custom_client:int_custom_payment:app_storefront_base"
}File Upload
Upload individual files or entire cartridges to your sandbox:
| Action | Shortcut | Description |
|---|---|---|
| Upload Current File | Ctrl+Shift+U | Upload the active file |
| Upload Cartridge | Right-click → Upload | Upload an entire cartridge |
| Upload on Save | Automatic | Configurable auto-upload on file save |
| Clean Upload | Right-click → Clean & Upload | Delete remote cartridge first, then upload |
Clean Upload will delete all files in the remote cartridge before uploading. Make sure you have all local files saved before using this option.