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

🌐
Reddit
reddit.com › r/vscode › settings json
r/vscode on Reddit: Settings JSON
August 11, 2018 -

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...

Discussions

setting.json "Can Not edit in read-only editor"
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.... More on github.com
🌐 github.com
9
October 13, 2020
How to open Visual Studio Code's 'settings.json' file - Stack Overflow
The fact that someone had to ask ... to view settings", and the fact that so many of us had to Google it, shows how much VS Code needs to be improved in terms of design. 2022-08-23T16:00:18.53Z+00:00 ... With latest VSCode 1.84.2 the steps explained open a defaulSettings.json in read only ... More on stackoverflow.com
🌐 stackoverflow.com
Cannot Edit Default Settings
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... More on github.com
🌐 github.com
2
September 6, 2018
VS Code: Workaround for read-only settings
Hi! I’m learning Nix and trying to describe my Mac profile config with Nix. I’ve installed VSCode (actually VSCodium) and successfully configured it through helpful Home Manager options. However, using the app is very annoying as it constantly tries to modify settings (e.g. when my system ... More on discourse.nixos.org
🌐 discourse.nixos.org
1
0
February 12, 2024
🌐
Visual Studio Code
code.visualstudio.com › docs › reference › default-settings
Default settings reference
November 3, 2021 - To view the list of default settings, run the Preferences: Open Default Settings (JSON) command from the Command Palette (⇧⌘P (Windows, Linux Ctrl+Shift+P)). This opens a read-only file named defaultSettings.json that contains all the default settings in JSON format.
🌐
Visual Studio Code
code.visualstudio.com › docs › configure › settings
User and workspace settings
November 3, 2021 - Workspace settings - Settings stored inside your workspace and only apply when the workspace is opened. VS Code stores setting values in a settings JSON file.
🌐
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
Top answer
1 of 14
700

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"
}
🌐
GitHub
github.com › microsoft › vscode › issues › 103765
Cannot Edit Default Settings · Issue #103765 · microsoft/vscode
September 6, 2018 - 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
Find elsewhere
🌐
Techstacker
techstacker.com › how to change vscode default settings ui to settings.json
How to Change VSCode Default Settings UI to settings.json – Techstacker
January 1, 2019 - { "workbench.settings.editor": "json", "workbench.settings.useSplitJSON": true } If you’re confused, here’s a quick video demonstration of the entire process: You can confirm that you now control your VSCode editor via the settings.json file instead of the Settings UI.
🌐
Restack
restack.io › p › customizable-ai-user-interfaces-answer-visual-studio-code-settings-json-read-only-cat-ai
Visual Studio Code Settings Json Read Only | Restackio
November 24, 2020 - The ReadOnlyConfig option can be set to either true or false: true: This is the default setting. When enabled, any changes made through the System Console will be ignored, ensuring that the config.json files across all servers remain identical.
🌐
w3tutorials
w3tutorials.net › blog › cannot-edit-default-vscode-json-settings
How to Fix 'Cannot Edit in Read-Only Editor' When Editing Default VSCode JSON Settings on Windows 10 — w3tutorials.net
August 1, 2020 - Before diving into fixes, let’s ... the most common causes. The #1 reason for this error is editing the default settings file instead of your user-specific settings.json....
🌐
GitHub
github.com › microsoft › vscode-dotnettools › issues › 2556
setting.json appears to be read-only and can't be modified · Issue #2556 · microsoft/vscode-dotnettools
November 23, 2025 - Type: Bug extension demands removing of a line in the setting.json but the file is read-only. Cant be modified not even runing as adminitrator. Settings.json Configuration Error - Opening a Solution file is no longer required to work wit...
Author   gohan8
🌐
Reddit
reddit.com › r/vscode › edit defaultsettings.json?
r/vscode on Reddit: Edit defaultsettings.json?
January 14, 2024 -

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?

🌐
Bobby Hadz
bobbyhadz.com › blog › code-is-already-running-vscode
Code is already running / Cannot edit in read-only editor | bobbyhadz
March 14, 2020 - You can't edit the default settings.json file because it is in read-only mode.
🌐
Stefan Judis
stefanjudis.com › today-i-learned › readonly-files-in-vscode
Readonly files in VSCode | Stefan Judis Web Development
March 6, 2024 - The "Readonly include" option accepts files or glob patterns. And voila! I can't edit these generated files in VS Code anymore now. The trick is not to define this setting in your global config but rather in your workspace or project config at your-project/
🌐
GitHub
github.com › microsoft › vscode › issues › 161715
Add a setting to mark a set of files as readonly · Issue #161715 · microsoft/vscode
January 15, 2026 - The associated PR interposes on TextEditorModel.isReadonly() to mark glob-designated files as readonly providing a 99% solution for #4873 (6 yrs & 378 upvotes) This first PR is without a 'mode' or interactive 'keyboard command'; (altho, yes: I love the feature in gnuemacs) but users can quickly edit settings.json to change state of individual files, or when sufficiently motivated, write an extension command to auto-edit settings.json.
Author   jackpunt
🌐
Medium
alinawrites.medium.com › how-to-find-settings-json-in-vscode-e6f678dbc01d
How to find settings.json In VSCode | by Alina Writes | Medium
October 6, 2022 - The settings.json file contains all of your Visual Studio Code settings. There is no quick way of opening it without going through plethora of other VSCode menus. So here are pretty much your only options. Before proceeding to learn from this tutorial…please help our mission. Get coding books with my #Octopack discount for Medium readers...
🌐
GitLab
forum.gitlab.com › how to use gitlab
Editor is read-only VSCODE when trying to edit - How to Use GitLab - GitLab Forum
September 10, 2023 - Describe your question in as much detail as possible: So I am new in GitLab, setted my project from Github, imported everything just fine, the problem is when I try to edit the actual code What are you seeing, and how…
🌐
Semicolon
semicolon.dev › vscode › how-to-open-settings-json
Fastest Way To Open settings.json In VSCode (Where is VS Code's settings file?)
Don't get me wrong. VSCode is an amazing editor. But it feels a bit all over the place, when it comes to finding settings files. So I created this page to show you how to open settings.json (the main settings file in VS Code) fast.