# How to keep VS Code in the Dock on Mac: Control-click steps for macOS

> How to keep VS Code in the Dock on Mac: Control-click the icon, choose Options > Keep in Dock, and fix the common snags. Desktop app steps for 2026.

URL: https://www.lazur.app/how-to/keep-vs-code-in-the-dock-in-vs-code
Updated: 2026-11-09

Open VS Code from the Applications folder, then Control-click its icon in the Dock and choose Options > Keep in Dock. If you do not see Keep in Dock, open VS Code first, then Control-click the icon again.

## Quick answer

- Install VS Code in Applications, open it from there, then Control-click its Dock icon.
- Choose Options > Keep in Dock. The icon stays in the Dock after you quit.
- No Keep in Dock entry usually means VS Code is not open yet. Open it, then try again.
- To remove the icon, drag it out of the Dock until Remove appears. The app stays on your Mac.

Applies to: VS Code desktop app on macOS, Intel and Apple silicon Macs. Time: 3 min. Difficulty: Easy.

## What you need

- A Mac with an Intel or Apple silicon processor, both supported by the VS Code macOS page
- VS Code installed in the Applications folder from the official DMG
- VS Code 1.145 or a newer update, per the VS Code updates page
- The desktop app. These Dock steps do not apply to vscode.dev in a browser

## How to Keep VS Code in the Dock on a Mac in VS Code on a Mac

1. **Move VS Code into Applications.** Open the VS Code disk image and drag Visual Studio Code.app into the Applications folder. Keep the app in that folder so the Dock always points at one copy. Tip: If you are not sure which build to download, the Universal DMG covers both Intel and Apple silicon Macs.
2. **Open VS Code from Applications.** Open the Applications folder and double-click Visual Studio Code. Wait for the window to appear. The icon now sits in the Dock while the app runs. Tip: Open it from Applications, not from the disk image, so the pin points at the installed copy.
3. **Control-click the Dock icon.** Shortcut: ⌃-click. Hold the Control key and click the VS Code icon in the Dock. A menu opens above the icon. Tip: The official macOS page says Control-click. It does not say right-click, so use the Control key.
4. **Choose Options, then Keep in Dock.** (Control-click the Dock icon > Options > Keep in Dock) Move the pointer to Options in the menu. In the submenu, click Keep in Dock. The app now stays in the Dock after you quit VS Code. Tip: If you do not see Keep in Dock, VS Code may not be open. Open it, then Control-click again.
5. **Quit and check the icon.** Quit VS Code, then look at the Dock. The icon should remain in place. Open VS Code again to confirm the pin holds. Tip: If the icon is still there after a restart, the pin worked.
6. **Pin by dragging, if you prefer.** With VS Code open, drag its icon to the left of the line that separates apps from recently used apps. Apple's Dock help says this adds the app to the Dock. Tip: Apple's wording also allows above the line. Use whichever suits your Dock layout.
7. **Bring back a missing icon.** If the icon is gone, open VS Code from Applications. Control-click the icon that appears in the Dock, then choose Options > Keep in Dock again. Tip: This is the fix Apple's Dock help gives for an icon you removed.
8. **Remove the icon without uninstalling.** Drag the VS Code icon out of the Dock. Keep dragging until the word Remove appears, then let go. Apple says this removes only the Dock alias, and the app stays on your Mac. Tip: To uninstall VS Code, remove the app from Applications. Dragging out of the Dock does not do that.

Once VS Code sits in your Applications folder, pinning it takes one menu. This guide covers the desktop app on macOS. It also covers dragging the icon in, fixing a missing pin, removing the icon without uninstalling, and the errors people hit most.

## Start with the right copy of VS Code

Most Dock problems start with where the app lives. The official macOS page tells you to drag Visual Studio Code.app into the Applications folder, then open it from there. One copy in one place means the Dock icon always points at the app you actually use. Pinning the copy you opened from the disk image is an easy mistake to make.

Choose the right download, too. The VS Code updates page lists version 1.145, released November 4, 2026. macOS builds come as Universal, Intel, and Apple silicon DMG files. If you are not sure which chip your Mac uses, the Universal build is the safer pick.

- **1.145** VS Code version on the updates page, released November 4, 2026 ([source](https://code.visualstudio.com/updates))
- **75.9%** of all Stack Overflow 2025 survey respondents said they use Visual Studio Code ([source](https://survey.stackoverflow.co/2025/technology))

## Why the menu uses Control-click

The official VS Code page is specific about this step. It says to Control-click the icon in the Dock. It never says right-click. Hold the Control key on your keyboard, then click the icon. The menu that opens holds an Options submenu, and Keep in Dock lives inside that submenu.

A plain click does something else. It opens VS Code or brings its window forward, so it never shows the pin menu. If nothing appears after you Control-click, make sure you clicked the VS Code icon and not an empty part of the Dock.

![Developer at a Mac desk who keeps VS Code in the Dock on Mac for quick access](https://images.lazur.app/content-images/howto/keep-vs-code-in-the-dock-in-vs-code/how-to-keep-vs-code-in-the-1-a48771.jpg)

## Why Keep in Dock sometimes does not show up

A missing option is almost always about the app's state, not the menu. Apple's Dock help says that if you removed an app's icon, you open the app again to bring the icon back. Then you Control-click it and choose Options > Keep in Dock.

VS Code's own page says the same thing in fewer words. If there is no Keep in Dock entry, open VS Code first, then Control-click. Open the app first, then Control-click. That order is the whole fix.

Here is a worked example. You drag VS Code from the disk image into Applications. You double-click it, and the icon appears in the Dock. You Control-click the icon, choose Options, then Keep in Dock. You quit and reopen the app, and the icon is still there.

You do not need to reinstall VS Code for a missing pin. Launch it from Applications, wait for the icon, and repeat the pin step.

## Drag the icon in instead of using the menu

Dragging works too, and Apple describes it in its Dock help. Open VS Code so its icon sits in the Dock. Then drag that icon to the left of the line that separates apps from recently used apps. Apple's help words it as left of, or above, that line.

![Close view of a laptop keyboard during a coding session on a Mac](https://images.lazur.app/content-images/howto/keep-vs-code-in-the-dock-in-vs-code/how-to-keep-vs-code-in-the-2-49d744.jpg)

Use the menu when you only want the icon to stay put. Use dragging when you want VS Code next to the apps you already keep in the Dock. Both methods leave the app in Applications where it belongs.

## How to take VS Code out of the Dock without uninstalling it

Removing the icon is not the same as uninstalling the app. Drag the icon out of the Dock until a Remove label appears, then let go. Apple says this removes only the Dock alias, and the app stays on your Mac.

| Action | What changes | What stays the same |
| --- | --- | --- |
| Drag icon out until Remove appears | The Dock icon goes away | The app stays in Applications |
| Choose Options > Keep in Dock | The icon stays in the Dock after you quit | The app is unchanged |
| Drag app left of the recent-apps line | The icon is added to the Dock | The app is unchanged |

_Dock actions for VS Code and what each one changes, based on Apple's Dock help._

Say you want a cleaner Dock on a laptop with little screen space. Drag VS Code out until Remove appears, let go, then open Applications to confirm the app is still there. You can reopen it at any time.

## Desktop app or web version: pin the right one

A second mistake is pinning the wrong version. Some people open VS Code in a browser at vscode.dev. That version is a different tool. The official web docs say the terminal and debugger are not available there, and only a subset of extensions can run.

The web version also changes some shortcuts. ⌘N opens a new browser window, and Firefox reserves ⇧⌘P, where F1 is the documented workaround. The Dock steps in this guide apply to the desktop app. The official pages used for this guide do not say whether vscode.dev can be pinned to the Dock.

## Common mistakes with the Dock pin

- Pinning from the disk image. Move the app to Applications first, then open it from there.
- Looking for Keep in Dock while VS Code is closed. Open the app first so the entry appears.
- Dragging the icon off the Dock and thinking you uninstalled. The app stays in Applications.
- Mixing up the desktop app with vscode.dev. Only the desktop app gets these Dock steps.
- Expecting the Dock to fix the terminal command. The code command needs its own setup.

## Set up the code command next

The Dock pin and the terminal command are separate jobs. If you want to run code from Terminal, press ⇧⌘P to open the Command Palette. Then run Shell Command: Install 'code' command in PATH. The full label can read Install 'code' and optionally 'copilot' commands in PATH. If Copilot CLI install is disabled, it reads Install 'code' command in PATH.

Then start a new terminal. The official page says to remove any old code alias from an earlier version in your shell profile. Check that file if the command still points somewhere unexpected.

## Updates, quarantine, and the Dock icon

If VS Code does not update after a restart, the official macOS page says macOS might have set the app under quarantine. Community fixes exist for this. They are unverified, so this guide leaves them out.

If the icon goes missing after any update, follow the missing-icon steps above. You do not need to start over. Open the app, Control-click the icon, and choose Options > Keep in Dock again.

## Who pins VS Code, and where to go next

VS Code is widely used. In the Stack Overflow 2025 Developer Survey, 75.9% of all respondents said they use it, against 29% for Visual Studio. If you write code on a Mac every day, a Dock pin means one click each time you start work.

Role-specific setup lives on separate pages. Developers can read the [VS Code guide for developers on Mac](https://www.lazur.app/for/developers/vs-code). Data scientists can read the [VS Code guide for data scientists on Mac](https://www.lazur.app/for/data-scientists/vs-code). QA testers can read the [VS Code guide for software QA testers on Mac](https://www.lazur.app/for/software-qa-testers/vs-code). To change the look of the editor, see [how to change the color theme in VS Code on Mac](https://www.lazur.app/how-to/change-the-color-theme-in-vs-code).

Pin the app, quit, and reopen it once to confirm the icon stays. If it does, the job is done. If you use the terminal, run the shell command step next.

## Shortcuts

- Open the Command Palette in the desktop app: ⇧⌘P
- Open the Dock icon menu with Control-click: ⌃-click
- New browser window in vscode.dev (web only): ⌘N
- Command Palette in vscode.dev when Firefox reserves ⇧⌘P: F1

## If it does not work

- **Keep in Dock does not appear in the menu** Open VS Code from Applications, then Control-click the running icon again. The option sits in the Options submenu.
- **The icon disappeared from the Dock** Open VS Code from Applications. When the icon returns, Control-click it and choose Options > Keep in Dock.
- **The code command is not found in Terminal** Run Shell Command: Install 'code' command in PATH from the Command Palette, start a new terminal, and remove any old code alias in your shell profile.
- **VS Code does not update after a restart** The official macOS page says macOS might have set the app under quarantine. Community fixes are unverified, so check the official VS Code docs before you change system settings.

## With Lazur

Lazur is a voice assistant for the Mac that lives in the notch. Hold ⌥ ⌘ and ask; it sees your screen, answers out loud, points at buttons and walks you through apps. Hold fn to dictate. Free for 3 days, then $18/month: https://www.lazur.app/download

- “Where's the Keep in Dock option?”: Lazur circles Keep in Dock once the menu is open, then waits for your click before it points at the next step. (Walks you through it)

## FAQ

### Why is Keep in Dock missing from the VS Code icon menu?

VS Code has to be open when you Control-click. Open it from Applications first, then Control-click the running icon. The Options submenu then shows Keep in Dock.

### Can I drag VS Code into the Dock instead of using the menu?

Yes. Drag the VS Code icon to the left of the line that separates apps from recently used apps. Apple's Dock help also allows above that line, so use whichever fits your Dock layout.

### Does removing VS Code from the Dock uninstall it?

No. Drag the icon out until Remove appears. Apple says this removes only the Dock alias, and the app stays on your Mac. To uninstall, remove the app itself from Applications.

### Can I pin vscode.dev to the Dock on a Mac?

The Dock steps on this page are for the desktop app. The official web docs used for this guide do not cover pinning vscode.dev, so do not count on it. The web version also lacks a terminal and debugger.

### Which VS Code download should I choose for my Mac?

The updates page lists Universal, Intel, and Apple silicon DMG files for macOS. Choose Universal if you are not sure which chip your Mac has. Choose Intel or Apple silicon only if you know which one fits.

### What if the Dock icon disappears after a VS Code update?

Open VS Code from Applications, Control-click the icon that appears, and choose Options > Keep in Dock again. Apple's Dock help gives the same fix for any icon you removed.

### Why does the official page say Control-click instead of right-click?

The official macOS page uses the term Control-click. This guide follows that wording, so the gesture is the Control key plus a click on the Dock icon.

### Do the menus match on older versions of macOS?

The Apple Dock help page used for this guide is labeled for macOS 27. The steps match VS Code's own wording, but exact menus may differ on older macOS versions, so check the menus on your Mac.

### Do I need the code command to keep VS Code in the Dock?

No. The Dock pin works without it. The code command is for Terminal use. Run Shell Command: Install 'code' command in PATH from the Command Palette if you want it.

## Sources

1. [Visual Studio Code on macOS](https://code.visualstudio.com/docs/setup/mac), Microsoft, checked 2026-11-09
2. [VS Code Updates](https://code.visualstudio.com/updates), Microsoft, checked 2026-11-09
3. [Visual Studio Code for the Web](https://code.visualstudio.com/docs/remote/vscode-web), Microsoft, checked 2026-11-09
4. [Add or remove Dock icons on Mac](https://support.apple.com/guide/mac-help/add-or-remove-dock-icons-mh35859/mac), Apple, checked 2026-11-09
5. [Stack Overflow Developer Survey 2025: Technology](https://survey.stackoverflow.co/2025/technology), Stack Overflow, checked 2026-11-09