Skip to content
| Marketplace
Sign in
Visual Studio Code>Visualization>Image List ViewNew to Visual Studio Code? Get it now.
Image List View

Image List View

fatcorn753

|
1 install
| (0) | Free
Show only the images you pick, side by side in one tab, vertically or horizontally
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Image List View

VS Marketplace Installs

Show only the images you pick, side by side in a single VS Code tab, vertically or horizontally. Handy for comparing many experiment plots at once.

Click an image in the Explorer, or drag & drop it, and it is added to the list.

The list split to the right of the editor, images stacked vertically

(The screen is an illustration, and the plots are made-up sample data.)

English | 日本語

The UI follows VS Code's display language (English or Japanese).

Features

  • Opening an image by clicking or drag & drop adds it to the list instead of opening a single preview. The list opens automatically if none is open.
  • Stack images in one column, or line them up in one row (no wrapping, scroll sideways). No limit on the number of images.
  • Sort by name, modified time, created time, or size, ascending or descending. Name sort compares numbers as numbers, so run2 comes before run10.
  • Filter by file name (substring or glob).
  • Set the width of each image from 80 to 2000 px.
  • Remove images from the list and bring them back (the files are never deleted).
  • The list updates automatically when images in a folder are added, changed, or deleted.

How it differs from other image extensions

Most image extensions for VS Code either show one image at a time, or show every image in a folder as a gallery. Image List View is built for a different job: comparing a handful of images you choose, next to your code.

  • Only the images you pick. Click or drag images to add them, and remove the ones you no longer need. Nothing else in the folder gets in the way.
  • One column or one row, sized to fit. Stack images vertically or line them up horizontally, and use the width slider to fit them into a split editor beside or below your code.
  • Made for numbered results. Name sort puts run2 before run10, and a glob filter such as exp_*_run{1,2}_*.png narrows down a series of experiment plots.
  • Stays up to date. When your script writes new plots, the list refreshes on its own.

Installation

Search for "Image List View" in the Extensions view (Cmd+Shift+X / Ctrl+Shift+X), or install it from the Marketplace page.

From the command line:

code --install-extension fatcorn753.image-list-view

Without Marketplace access, download the .vsix from Releases and use "Install from VSIX..." in the "..." menu of the Extensions view.

Usage

  1. Click an image in the Explorer. Instead of the usual single preview, the image list opens with that image in it. Images you click next are added to the same list.
  2. Dragging images from the Explorer onto the editor area (including the list) adds them the same way. Dropping several at once puts them all in one list.
  3. To add a whole folder, hold Shift while dropping it onto the list (without Shift, VS Code does not hand folders to the list). You can also pick it with "+ Add" in the toolbar.
  4. Hover an image to show "×" at its top right. Click it to remove the image from the list (the file is not deleted).
  5. Click an image in the list to open it alone in VS Code's built-in preview beside the list.

Opening images one at a time as usual

The setting imageListView.clickToAdd (on by default) controls whether opening an image adds it to the list. You can change it with any of these:

  • The "Click to add" checkbox in the list toolbar
  • "Image List View: Toggle Click to Add" in the Command Palette
  • Searching for imageListView.clickToAdd in Settings

While it is off, the status bar at the bottom right shows "Image List (adding off)".

Using it in a split editor

The list is an ordinary editor tab, so you can place it beside or below your code. A split leaves less room for the list, so use the "Width" slider in the toolbar to fit the images.

  • Split right (image above): choose "Vertical" and set the width to fit the list area (for example 420 px). Scroll through the plots while you read the code.
  • Split down (image below): choose "Horizontal" and make the width small (for example 250 px). Compare many plots in one row at a glance.

The list split below the editor, images lined up horizontally

To split, drag the list tab to the right or bottom edge of the editor area, or right-click the tab and choose "Split Right" or a similar command.

Other ways to open the list

  • Click "Image List" in the status bar at the bottom right to open an empty list (or bring the existing one to the front).
  • Right-click folders or images (multiple selection works) in the Explorer and choose "Show Images in List" to open a new list with them.
  • With several lists open, images go to the list you used last.
  • Switching to a tab that is already open does not add its image.

Toolbar

Item What it does
+ Add Pick files or folders in a dialog and add them to the list
Click to add Turns the setting imageListView.clickToAdd on or off (applies to all of VS Code)
Restore N removed Puts back every image removed with ×. Shown only when some are removed
Filter Without wildcards: case-insensitive substring match (for example loss). Globs with * ? ** {a,b} also work (for example exp_*_run{1,2}_*.png). A pattern with / is matched against the path relative to the folder
Sort Name, modified, created, or size. The button next to it switches ascending and descending
Vertical / Horizontal Vertical: one column. Horizontal: one row without wrapping. Scroll to see the rest
Width Width of each image (80–2000 px)
Include subfolders Shown only when a folder is in the list. .git and node_modules are skipped
  • Sort order, layout, width, and other settings are remembered for the next list (the filter text is not carried over).
  • Supported formats: png, jpg/jpeg, gif, webp, bmp, svg, ico, avif
  • Up to 5000 images are loaded at a time.

Notes

  • While "Click to add" is on, an image opened in any way (Quick Open and so on) goes into the list. To view a single image, click it inside the list or turn the setting off.
  • Remote environments (SSH, WSL, containers) are not tested.

Development

Plain JavaScript with no dependencies and no build step.

File Role
extension.js The extension (panels, folder scanning, file watching, click to add)
package.nls*.json, l10n/ Translations of command names and UI text (English is the source, Japanese is the translation)
media/logic.js Pure functions for filtering and sorting (shared by the webview and the Node tests)
media/main.js, media/main.css The list UI
test/logic.test.js Unit tests for media/logic.js
test/integration/index.js Integration tests that run in a real VS Code

Unit tests:

npm test

Build a package (creates a .vsix):

npm run package

The integration tests write and delete a file in the folder you pass, so use a throwaway folder. Put a few images directly in it and one image in sub/. Keep --user-data-dir short (a long path makes the IPC socket fail). Example on macOS:

IMAGE_LIST_TEST_DIR=/tmp/ilv-imgs "/Applications/Visual Studio Code.app/Contents/MacOS/Code" --extensionDevelopmentPath=$PWD --extensionTestsPath=$PWD/test/integration/index.js --user-data-dir=/tmp/ilv-ud --extensions-dir=/tmp/ilv-ext /tmp/ilv-imgs

License

MIT

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft