The default settings in vscode is a non-editable document. It acts as a way for you to view the default settings for native settings as well as extension default settings.

These defaults are also used to identify when a setting has changed with a 'blue' line indicator, when using the settings editor:

Changes to settings are reloaded by VS Code as you change them. Modified settings are now indicated with a blue line similar to modified lines in the editor. The gear icon opens a context menu with options to reset the setting to its default value as well as copy setting as JSON.

Currently, vscode only offers 2 editable settings:

VS Code provides two different scopes for settings:

  • User Settings - Settings that apply globally to any instance of VS Code you open.
  • Workspace Settings - Settings stored inside your workspace and only apply when the workspace is opened.

Workspace settings override user settings. Workspace settings are specific to a project and can be shared across developers on a project.

Note: A VS Code "workspace" is usually just your project root folder. Workspace settings as well as debugging and task configurations are stored at the root in a .vscode folder. You can also have more than one root folder in a VS Code workspace through a feature called Multi-root workspaces.

You can configure these settings with the settings editor, as pictured above, or you can navigate to their JSON counterparts for manual entry (example pictured on the right below).

For workspace settings JSON, the JSON file is located in a folder of the root directory called .vscode, you can create it yourself if it is not there.

By default, VS Code shows the Settings editor, but you can still edit the underlying settings.json file by using the Open Settings (JSON) command from your command palette or by changing your default settings editor with the workbench.settings.editor setting.


Settings

You can define which view is shown using the following settings:

  • workbench.settings.openDefaultSettings

    Opens the default settings any time you open regular settings (this only works with the JSON settings editor option)

  • workbench.settings.editor

    Determine which editor to use, you can elect UI or JSON

  • workbench.settings.useSplitJSON

    This will open a JSON settings editor, with the default settings to the left, but the default editor to the left will behave like a UI editor in that you can collapse regions based on category and there is a search input box and it will share the same tab as the json editor on the right, whereas the workbench.settings.openDefaultSettings option mentioned above puts each setting view in its own respective tab (editor)

Answer from soulshined on Stack Overflow
Top answer
1 of 4
57

The default settings in vscode is a non-editable document. It acts as a way for you to view the default settings for native settings as well as extension default settings.

These defaults are also used to identify when a setting has changed with a 'blue' line indicator, when using the settings editor:

Changes to settings are reloaded by VS Code as you change them. Modified settings are now indicated with a blue line similar to modified lines in the editor. The gear icon opens a context menu with options to reset the setting to its default value as well as copy setting as JSON.

Currently, vscode only offers 2 editable settings:

VS Code provides two different scopes for settings:

  • User Settings - Settings that apply globally to any instance of VS Code you open.
  • Workspace Settings - Settings stored inside your workspace and only apply when the workspace is opened.

Workspace settings override user settings. Workspace settings are specific to a project and can be shared across developers on a project.

Note: A VS Code "workspace" is usually just your project root folder. Workspace settings as well as debugging and task configurations are stored at the root in a .vscode folder. You can also have more than one root folder in a VS Code workspace through a feature called Multi-root workspaces.

You can configure these settings with the settings editor, as pictured above, or you can navigate to their JSON counterparts for manual entry (example pictured on the right below).

For workspace settings JSON, the JSON file is located in a folder of the root directory called .vscode, you can create it yourself if it is not there.

By default, VS Code shows the Settings editor, but you can still edit the underlying settings.json file by using the Open Settings (JSON) command from your command palette or by changing your default settings editor with the workbench.settings.editor setting.


Settings

You can define which view is shown using the following settings:

  • workbench.settings.openDefaultSettings

    Opens the default settings any time you open regular settings (this only works with the JSON settings editor option)

  • workbench.settings.editor

    Determine which editor to use, you can elect UI or JSON

  • workbench.settings.useSplitJSON

    This will open a JSON settings editor, with the default settings to the left, but the default editor to the left will behave like a UI editor in that you can collapse regions based on category and there is a search input box and it will share the same tab as the json editor on the right, whereas the workbench.settings.openDefaultSettings option mentioned above puts each setting view in its own respective tab (editor)

2 of 4
17

I had the same problem and the solution that worked is below. It is true that default settings cannot be modified, but the below steps explain how to edit the settings in JSON:

  1. Cmd+Shift+P and select Open Settings UI (Ctrl+Shift+P for Windows I think)
  2. Search for "Settings" and under "Workbench" click on Settings Editor. Change from "ui" to "json".
  3. Search for “use split JSON” and tick “Controls whether to use split JSON…”.

Credit to Ahmad Awais video posted here

🌐
GitHub
github.com › microsoft › vscode › issues › 103765
Cannot Edit Default Settings · Issue #103765 · microsoft/vscode
August 1, 2020 - VSCode Version: 1.47.3 OS Version: Windows 10, Version 1809 Steps to Reproduce: Open Default Settings ("File -> Preferences -> Settings") Type in Default Settings json file to edit. Window appears "Cannot edit in read-only editor" Does t...
Author   adam-grant-hendry
🌐
Visual Studio Code
code.visualstudio.com › docs › reference › default-settings
Default settings reference
November 3, 2021 - Visual Studio Code comes with a set of default settings that can be overridden by user or workspace settings. You can change the default settings by using the Settings editor or by editing the settings.json file directly.
🌐
Reddit
reddit.com › r/vscode › edit defaultsettings.json?
r/vscode on Reddit: Edit defaultsettings.json?
July 1, 2020 -

Hi Experts,

I’m new to VSCode so pardon me if this is seems to be a noob question.

I set up a central coding server so keep all my projects in one place and I’m now trying the VSCode remote feature. Every-time I open a new environment the settings I made on the User Workspace are being over written by the default settings on new environment. This is forcing me to redo the setting that I already made before.

Now the questions is, what is the best way to edit the default settings in a way that it will push your preferred settings down to the new environment/workspace?

🌐
Visual Studio Code
code.visualstudio.com › docs › getstarted › settings
User and workspace settings
February 6, 2025 - The gear icon alongside the setting (⇧F9 (Windows, Linux Shift+F9)) opens a context menu with options to reset a setting to its default value, and to copy the setting ID, copy a JSON name-value pair, or copy the settings URL. ... A settings URL enables you to navigate directly to a specific setting in the Settings editor from the browser. The URL is in the format vscode://settings/<settingName>, where <settingName> is the ID of the setting you want to navigate to.
🌐
Reddit
reddit.com › r/vscode › settings json
r/vscode on Reddit: Settings JSON
May 16, 2020 -

Hello,

I am following online course and currently we need to change something in User Settings (JSON). The video shows (in VScode) that i need to follow path Code -> Preferences -> Settings and then press on three dots and open settings json. However, on my mac i don't have such option as these three dots.

I managed to open these settings by using keyboard: CMD + Shift + P. It opens dropdown list where i choose Preferences: Open Default Settings (JSON). This is the code which looks the same as my instructor has and i can locate code line i need to update: "code-runner.executorMap" . Learning about Virtual Environments in VSCode. However, the settings opens in read only mode and i can't edit them. How can i open them so i can edit them?

I am complete beginner, had the same problem right at the begining of this online course when we learned about debugging, but i couldn't find an answer so i decided to move on and come back when i understand more about programming itself etc. And here i am, starting to get the idea of programming, but still can't find solution to this one...

🌐
GitHub
github.com › microsoft › vscode › issues › 108594
setting.json "Can Not edit in read-only editor" · Issue #108594 · microsoft/vscode
October 13, 2020 - Issue Type: Feature Request the default setting.json occurs problems, unable to settle with notification "Can Not edit in read-only editor", how to solve this? VS Code version: Code 1.50.0 (93c2f0f, 2020-10-07T06:10:52.432Z) OS version: ...
Author   Gnnhnk
Find elsewhere
Top answer
1 of 14
701

To open the User settings:

  • Open the command palette (either with F1 or Ctrl+Shift+P)
  • Type ">open settings" (You must include the '>' at the beginning)
  • You are presented with a few options¹, choose Open User Settings (JSON)

This image was taken in the VS Code online editor

Which, from the manual and depending on platform, is one of:

  • Windows %APPDATA%\Code\User\settings.json²
  • macOS $HOME/Library/Application\ Support/Code/User/settings.json
  • Linux $HOME/.config/Code/User/settings.json

The Workspace settings will be in a {workspaceName}.code-workspace file where you saved it, and the Folder settings will be in a .vscode folder if and when it has been created.


Official page on User and Workspace Settings

As stated by sevencardz below, VS Code includes a button in the Settings UI gutter which can be used to switch between JSON and graphical view.

The workbench.settings.editor option selects which of the settings files is opened by default when not using the above method, such as with the shortcut +, or through the application menu.

Footnotes

  1. The aforementioned settings, User and Workspace. Remote settings will appear when using WSL.

  2. By a test this maps to %APPDATA%\Roaming\Code\User\settings.json, I am not sure by what logic.

2 of 14
185

On the settings UI page, there's a special button in the top right corner gutter that toggles between the settings.json file and the settings UI.

Bonus Answer:

Add "workbench.settings.editor": "json" to your settings.json file. This will make it so that menu FilePreferencesSettings or + , opens your settings.json file by default. Optionally, add a comment at the top to remind yourself where the toggle button is.

// Click the Open Settings (UI) button in the top
// right corner gutter to toggle the settings UI
{
    // Other settings in settings.json
    // ...
    "workbench.settings.editor": "json"
}
🌐
Techstacker
techstacker.com › how to change vscode default settings ui to settings.json
How to Change VSCode Default Settings UI to settings.json – Techstacker
December 15, 2020 - You can confirm that you now control your VSCode editor via the settings.json file instead of the Settings UI. Try to remove both configurations, so all that is left is the curly braces ({ }) and save your file. Then go back to your Settings UI, and you’ll see that the Settings Editor has changed back to “ui” and the Use Split JSON is now unchecked.
🌐
Visual Studio Code
code.visualstudio.com › docs › languages › json
Editing JSON with Visual Studio Code
November 3, 2021 - The current editor mode is indicated in the editor's Status Bar. Select the mode indicator to change the mode and to configure how file extensions are associated to modes. You can also directly modify the files.associations Open in VS Code Open in VS Code Insiders setting to associate file names or file name patterns to jsonc. To understand the structure of JSON files, we use JSON schemas. JSON schemas describe the shape of the JSON file, as well as value sets, default ...
🌐
SitePoint
sitepoint.com › general web dev
VS Code settings.json File Corrupted. Can I Recover a Default settings.json? - General Web Dev - SitePoint Forums | Web Development & Design Community
May 9, 2025 - First, thank you to all who responded to my post introducing myself. It was a kind and warm welcome. Thank you. The t-shirt I’m wearing today proclaims: “Pretty sure I seized the wrong day”. It is appropriate as I ha…
🌐
Supunkavinda
supunkavinda.blog › home › vscode settings.json secrets: decoding potential
Vscode Settings.Json: Tips and Techniques - Supunkavinda
May 8, 2024 - Craft project-specific configurations by creating a .vscode folder in the root directory and sculpting a settings.json file within. For instance: { "folder-specific-setting": "value", "another-setting": true } While workspaces lack a settings.json file, you can achieve similar results by editing your workspace.code-workspace, offering a snippet like:
🌐
Stack Overflow
stackoverflow.com › questions › 72651645 › vscode-missing-settings-in-settings-json-file
visual studio code - VSCode Missing settings in settings.json file - Stack Overflow
So I actually found the solution. It's kinda simple, open the Settings (UI), go to User -> Workbench -> Settings Editor and then changing the Editor to JSON. That way the Default.Settings.JSON will contain all the settings, even for VIM or other ...
🌐
GitHub
github.com › microsoft › vscode › issues › 173841
User's settings.json configurations are not applied in non-default profiles · Issue #173841 · microsoft/vscode
February 8, 2023 - *duplicateIssue identified as a duplicate of another issue(s)Issue identified as a duplicate of another issue(s)bugIssue identified by VS Code Team member as probable bugIssue identified by VS Code Team member as probable bugsettings-editorVS Code settings editor issuesVS Code settings editor issues ... So I created a profile and the went through my user's settings.json file. I realized that almost all of the configs are not applied. When hovering over the unapplied settings, This setting cannot be applied while a non-default profile is active.
Author   Ramin-RX7
🌐
YouTube
youtube.com › watch
How to Customize Visual Studio Code Settings.json - YouTube
In this developer productivity video, we will go over how to customize your Visual Studio Code settings. First, we go over what VS Code settings are used for...
Published   January 7, 2022
🌐
Reddit
reddit.com › r/vscode › where is settings.json?
r/vscode on Reddit: Where is settings.json?
February 27, 2022 -

Hi , I am new to VS Code, doing a python course. The course require to use an extension and change the settings by going and editing the json file. But when I open the settings.json file it is empty. If I click any option in the settings ui, that option is showing in the .json file but default settings are not shown. How do i fix this?