Manage updates in enterprise environments
VS Code releases weekly updates with new features, bug fixes, and security patches. Organizations can centrally manage how VS Code updates are handled across their development teams.
This article covers how IT admins can configure automatic updates through enterprise policies.
Update policy
VS Code provides the UpdateMode policy for controlling its built-in application updater. This policy controls the
update.mode
setting.
It does not prevent updates deployed by other software-management tools or control extension updates:
| Update mechanism | Where to manage it |
|---|---|
| Built-in application updater | Use UpdateMode and the modes below. |
| Linux package manager or Snap | Configure servicing through your package-management tools. Snap updates automatically unless you manage its refresh behavior separately. See Linux installation and updates. |
| Organization software deployment | Select and distribute approved builds through your deployment tools. UpdateMode does not block an external installer. |
| Extension updates | Manage extension servicing separately. See extension auto-update and its enterprise policies. |
Learn how to deploy policies to your organization's devices.
Update mode options
The UpdateMode policy accepts the following values:
| Value | Description |
|---|---|
default |
Automatic checking for updates is enabled and runs in the background |
start |
Check for updates only when VS Code starts |
manual |
Automatic checking is disabled; users can manually check for updates |
none |
The built-in application updater is disabled, including manual checks |
Disable automatic updates
To turn off the built-in application updater, including automatic and manual update checks, set the UpdateMode policy to none:
Policy value:
none
For installations that use the built-in updater, users cannot update VS Code through the application while this policy is set. You must distribute updates through your software deployment tools.
Enable manual updates only
To allow users to check for updates manually while disabling automatic background checks, set the UpdateMode policy to manual:
Policy value:
manual
For installations that use the built-in updater, users can check for updates from Help > Check for Updates on Windows and Linux, or Code > Check for Updates on macOS.
Check for updates at startup only
To check for updates only when VS Code starts, without background checking, set the UpdateMode policy to start:
Policy value:
start
Verify and service managed installations
Before deploying a configuration broadly:
-
Select an approved build for each target platform and installation type. Use the version-specific download links when your deployment requires a particular version.
-
Deploy the build and update policy to a test group.
-
Run Developer: Policy Diagnostics and confirm the effective
UpdateModevalue and source. For installations with the built-in updater, verify that update checks behave as intended. Validate package-manager and extension update controls separately. -
Confirm the installed version, test representative development workflows, and expand the deployment only after those checks pass.
Keep a process for distributing security and maintenance updates when the application's updater is disabled. If Copilot enterprise-managed settings require a newer client, AI features can remain unavailable until you deploy a version that meets the minimum version requirement.
Network requirements
The built-in updater checks for and downloads updates from Microsoft services. If your network has restricted access, account for both the update service and download CDN:
update.code.visualstudio.com- VS Code download and update servervscode.download.prss.microsoft.com- VS Code download CDN
See the network documentation for other service hostnames. Linux repository and Snap downloads use their respective package-distribution services.
Related resources
- Enterprise policies reference - Complete list of enterprise policies
- Network connections - Proxy and firewall configuration