Skip to content
| Marketplace
Sign in
Visual Studio Code>Visualization>Image ViewerNew to Visual Studio Code? Get it now.
Image Viewer

Image Viewer

Easy VSCode

|
103,680 installs
| (11) | Free
An image viewer and workspace gallery with zoom, pan, rotation, flip, and same-folder navigation. Browse project images with search, filters, and flexible gallery layouts.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Image Viewer

English | 中文

Use Image Viewer as your default image viewer in VS Code. Get zoom up to 800% (1600% for tiny images), click/Space zoom cycling, rotation and flipping, a navigation minimap, and same-folder image navigation. Make it the default.

Browse project assets in VS Code and Cursor with a continuous image wall, folders, search, and filters.

Click any screenshot to view it at full size.

Video demo

Watch the image wall and folder navigation in action.

Watch or download the video.

Quick start

To… Do this
Open an image Right-click an image in Explorer → Open With... / Reopen Editor With... → Image Viewer
Use Image Viewer by default Open the Command Palette (Ctrl+Shift+P / ⌘⇧P) → Image Viewer: Use as Default Image Editor
Browse the workspace Open a folder or workspace → run View Images 🌄 from the Command Palette
Browse a specific folder Right-click the folder in Explorer → View Images 🌄; opens the project gallery at that folder

Single-image viewer

Zoom into details, pan with the minimap, and browse nearby images without changing the original files.

Single-image viewer with zoom, rotation, flip, and navigation minimap

  • Zoom and pan: use the mouse wheel, toolbar, or enter a percentage. Press Space or click the image to cycle through two or three zoom levels suited to its size. All zoom controls share an 800% ceiling. Once the original image has loaded, images with a longest edge of 64px or less, including tiny SVG icons, have an extra 1600% preset. Pinch zoom is continuous within the same ceiling. Fit is capped at 100%.
  • Inspect details: drag an enlarged image or navigate with the minimap.
  • Rotate and flip: the toolbar keeps clockwise rotation; use R / Shift+R to rotate clockwise / counter-clockwise. Mirror buttons are hidden by default. Enable Settings → General → Show mirror buttons in the gallery, or VS Code's imageViewer.showMirrorButtons setting, to show both horizontal and vertical mirror controls in all previews. These operations do not change the original file.
  • Navigate: browse other images in the same folder with toolbar buttons, side arrows, or keyboard controls. The order follows Explorer's sorting settings.
  • Unobstructed viewing: the preview has an opaque black background and controls fade when idle. Clicking the background does not close the single-image editor; use its close button or Esc. Images outside the workspace can also be opened.

Filmstrip and adjacent-image loading

Use the filmstrip button in the preview toolbar to show or hide thumbnails. The single-image editor and gallery remember their switches independently; both default to off. The single-image strip contains only images directly in the current image's folder, excluding subfolders. Gallery strips follow the filtered and sorted sequence captured when the preview opens.

Large raster images use 200px long-edge thumbnails, requested for the visible strip window with a shared limit of six generation tasks across galleries and previews. Compressed file size does not bypass this rule. SVG and browser-renderable rasters already at most 200px use their original files and may scale up in the strip. Formats requiring conversion, such as TIFF, still use generation; failures show a placeholder rather than loading the original into the strip. Unselected thumbnails retain their brightness.

Adjacent-image preloading is enabled in both preview entries, independently of the filmstrip switch. It warms the previous and next image and uses up to two display slots with the component's default 600ms settle delay. Browser memory reclamation can still require decoding again, so preloading does not guarantee instant navigation.

Make it the default

Run Image Viewer: Use as Default Image Editor to open supported image files with this viewer by default. Installing or updating the extension leaves your editor choice unchanged.

This command replaces the supported filename patterns in the global User workbench.editorAssociations setting, including existing third-party choices for those patterns. Workspace and Workspace Folder associations can override it. There is no separate Image Viewer setting to enable or disable this default.

Use as Default Image Editor in the VS Code Command Palette

To stop using these global defaults, run Image Viewer: Remove Global Image Viewer Associations (formerly Restore VS Code's Default Image Editor), preferably before uninstalling. It removes only supported associations that still point to Image Viewer and does not restore earlier custom associations overwritten by setup. To use a previous viewer, select it through Reopen Editor With...; use Configure default editor... to make that choice persistent. Run the setup command again only when you want to enable Image Viewer defaults again. More about editor associations.

Workspace gallery

New galleries start in Grid. Select a folder in the sidebar and browse one continuous image wall. Click any thumbnail to open the large-image preview. Grid and Fill support 1–20 columns, live thumbnail sizing, and a compact mode for denser browsing.

Grid — see the whole image (default)

Images keep their original proportions without cropping, useful for comparing portraits, landscapes, and panoramic images.

Grid layout showing complete images

Fill — browse thumbnails

Square thumbnails fill the wall, making it easy to scan many images at once.

Fill layout: folders sidebar and continuous image wall

Compact and thumbnail size

Turn on Compact in the bottom toolbar. In Grid/Fill, it removes thumbnail gaps and the always-visible file names and sizes; hover to see a file name. Fill + Compact creates a seamless image wall, fitting more images on screen at the same column count.

Drag the Thumbnails slider to adjust 1–20 columns: right makes images larger with fewer columns; left fits more, smaller thumbnails. The tooltip shows the current pixel size and column count. Below, the six-column Fill example is changed to four columns + Compact.

Fill + Compact with four columns and 260 px thumbnails

List — inspect file information

View the file name, relative path, size, dimensions, and modified time alongside each thumbnail.

List layout with paths, sizes, dimensions, and modified times

Screenshot credits and licenses.

Themes

Click the theme button beside the bottom-right gear to cycle between Follow, Light, and Dark.

  • Follow (display icon): inherits your current VS Code/Cursor theme and color customizations, including your chosen custom theme, keeping the viewer's appearance consistent with the host editor.
  • Light (sun) and Dark (moon): use fixed palettes based on VS Code's default light/dark themes, independently of the editor's current theme.

Choose a thumbnail background separately: none, checkerboard for transparency, or a solid color.

Open from Explorer

Right-click a folder or file → View Images 🌄. The sidebar shows the project root and reveals your target. Images are highlighted in the wall and opened in the large-image preview; other files locate their containing folder. Empty folders fall back to the nearest ancestor with images, then the project root. Closing the preview returns to the located thumbnail.

Explorer entries in the same project reuse one gallery tab; different workspace roots have separate tabs. The gallery automatically updates images, folder nodes, and counts about 3 seconds after file changes stop, including copied, renamed, or deleted folders. Changes during a scan are checked again after it finishes; hidden tabs refresh when shown. Current filters and browsing position are retained where possible, and an open large-image preview keeps its current session. Empty folders remain hidden. Paths excluded by VS Code's files.watcherExclude may require Refresh images. If search/type filters hide the target, they are temporarily adjusted, with Restore filters available.

Find and organize images

  • Image folders: browse image-containing directories and their ancestors, see image counts, and expand or collapse branches. Hide or resize the sidebar.
  • Return from search to a folder: right-click an image → Reveal in Image folders. The gallery selects and centers its containing folder, temporarily clears image search, and highlights the original image among its neighbors. Use Restore filters to recover the search; Types and Include subfolders remain in effect.
  • Sorting: keep each folder's images together, or sort the whole collection by name, modified time, size, or format. In folder-first mode, dragging the scrollbar highlights the visible folders in the tree. A preview spanning multiple folders also shows group navigation; ordinary previous/next controls and the filmstrip keep the same flat sequence. Global sorting and single-image editors do not show folder-group controls.
  • File actions: reveal files, copy paths, names, or Base64, and move images to Trash after confirmation. Right-click folders to reveal, copy paths, or exclude them.
  • Settings and feedback: use the bottom-right gear for settings, bug reports, and feature requests.
  • Language: choose Follow VS Code, English, 简体中文, or 繁體中文 in Settings → General → Language. Unsupported editor languages default to English. All open gallery and single-image panels update immediately while preserving browsing and preview state.

Folder search and Include/Exclude

Type part of a folder name into Find folder in the left sidebar. Matching is case-insensitive; matching folders and their ancestors remain visible, with the tree expanded to reveal them. Click a result to show its images. Clear the search to restore the full tree.

Expand the filter button beside Find folder to set folders to include and folders to exclude. Include limits the gallery to selected folder trees; Exclude skips unwanted folders, such as build output. Folder search works within these rules, and can also be combined with the image name/path search and Types filter above the wall.

Use project-relative folder paths or Glob patterns (wildcard expressions). Enter one rule per line; press Enter or Apply to use the rules, and Shift+Enter to add a line.

Rule Selects
assets assets and all its subfolders
assets/{photos,icons}/** both folder trees
assets/set-* matching set folders and their subfolders
**/{dist,build} dist/build folders at any depth and their subfolders

Glob supports *, **, ?, character sets such as [ab], and alternatives such as {photos,icons}. Rules target folders, and a matching folder includes its descendants. Exclude takes priority over Include. Leave Include empty to browse all project folders; collapsing the fields keeps applied rules active.

Use Image folders → Include subfolders to choose whether the wall shows the selected folder's descendants. This is independent of Include/Exclude scan rules.

Performance and requirements

Item Details
Zoom ceiling 800%; 1600% for loaded originals whose longest edge is at most 64px
Image wall density 1–20 columns in Grid/Fill
Large-collection validation 100,000 images and about 10,000 directory nodes, using simulated data
Gallery browsing Load thumbnails at the current position first, without generating the entire collection in advance
Historical JPEG thumbnail benchmark (2026-10-14) 12 mixed-format images in about 0.61 seconds, 400px long edge, on Apple M1 Max after warm-up
Loading Visible thumbnails load first; generation runs in the background, up to 6 at a time
Thumbnail disk cache Automatic cleanup above 500 MiB or 25,000 files; temporary overshoots are possible
Requirements VS Code 1.92+ or a compatible Cursor version; macOS 11+ on Mac
Setup No separate runtime or compilation tools required

Gallery thumbnails use pixel dimensions to choose between the original and a generated thumbnail, regardless of compressed file size. Generated thumbnails with alpha use lossy WebP (Q78, effort 2) with lossless transparency; images without alpha use JPEG. Full-size previews use the originals. Generation failures show a retry placeholder instead of loading the full original. Large BMP/ICO thumbnails may be unavailable on platforms whose decoder does not support them; full-image viewing remains separate.

Cache cleanup is automatic. For manual gallery cleanup, run Image Viewer: Clean Gallery WebView Image Cache. Cache details.

Image formats

The gallery and image-editor entry recognize these extensions:

Formats Viewing notes
JPEG / JPG, PNG, WebP, BMP, ICO Common raster images, including transparent images where the format supports them
SVG Vector images, displayed directly
GIF, APNG Original-image animation depends on the host; generated thumbnails use a static first frame
AVIF Display and thumbnail availability depend on the host version and platform decoder
TIF / TIFF Gallery thumbnails can be generated for decodable files; a visible thumbnail does not guarantee large-image preview

Keyboard shortcuts

Inside the single-image viewer or gallery preview, click the circled question-mark button (View keyboard shortcuts) in the toolbar, or press ?, to open the read-only reference. Bindings are fixed; no customization settings are provided. Text fields keep normal editing keys, and IME composition does not trigger image actions.

Keys Action
← / Q, → / E Previous / next image; hold for continuous browsing
Home / End First / last image
PageUp / PageDown Previous / next folder group, when the gallery preview contains multiple groups in folder-first sorting
↑ / + / = / Numpad + Zoom in one stop
↓ / - / Numpad - Zoom out one stop
Space / Numpad 0 Adaptive observation zoom cycle, matching primary click
Main keyboard 0 / 1 Fit / actual size (100%)
R / Shift+R Rotate 90° clockwise / counter-clockwise
W / Numpad 8 Reveal up
S / Numpad 2 / Numpad 5 Reveal down
A / Numpad 4 Reveal left
D / Numpad 6 Reveal right
Numpad 7 Reveal upper-left
Numpad 9 Reveal upper-right
Numpad 1 Reveal lower-left
Numpad 3 Reveal lower-right
F Toggle VS Code window fullscreen
? Open / close shortcut reference
Esc Close the shortcut reference first; otherwise close the preview or single-image editor

Pan only works when the zoomed image overflows the viewport. Ctrl/⌘/Shift + arrow keys are left to the host. Numpad keys retain physical identity with NumLock off. Unless listed above, Ctrl/⌘/Alt combinations remain available to the host; Ctrl/⌘+Space does not run the zoom cycle. Esc does not exit VS Code window fullscreen: use F, the fullscreen button, or the native host shortcut. No video, deletion, EXIF, or selection shortcuts are added to entries without those features; filmstrip and flip controls keep their buttons without invented bindings.

Feedback

  • Changelog
  • Report a bug or request a feature
  • Contact: zhangjian1713@gmail.com
  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft