Easy Toggle Settings for Visual Studio Code

March 7, 2026 ยท View on GitHub

ci codecov Installs Marketplace Version

Features

Allows you to quickly and easily toggle any VS Code setting directly from the status bar.

You choose which settings to toggle. A button is added to the status bar for each.

Perfect for settings you frequently toggle.

demo

Installation

Install through VS Code extensions, searching for Easy Toggle Settings. Or go to Visual Studio Code Market Place: Easy Toggle Settings.

Usage

For example, let's say we want to toggle these settings:

  • editor.codeLens between true and false (with the icon disabled when false)
  • editor.renderWhitespace between "none" and "all"
  • java.autobuild.enabled between true and false at the workspace level

Open global settings (Ctrl Shift P > Open user settings json) and add at the end:

"easy-toggle-settings.items": [
  {
    "property": "editor.codeLens",
    "icon": "eye",
    "values": [true, false],
    "disabledValue": false // Optional
  },
  {
    "property": "editor.renderWhitespace",
    "icon": "whitespace",
    "values": ["none", "all"]
  },
  {
    "property": "java.autobuild.enabled",
    "icon": "rocket",
    "values": [true, false],
    "isWorkspace": true // Optional
  }
]

Icons can be found at Codicon

After saving the settings, the icons will appear in the status bar. Each click will toggle the setting between the declared values.

toolbar

๐ŸŽ‰ You can now do this for any VS Code setting! ๐Ÿฅณ

Extension Settings

This extension contributes the following settings:

  • easy-toggle-settings.enabled (boolean, default: true)
    Enables or disables the extension functionality.

  • easy-toggle-settings.items (array, default: [])
    List of settings to toggle. Each item must include:

    • property (string): Full name of any vscode setting (e.g., editor.codeLens)
    • icon (string): Codicon icon name (e.g., eye, whitespace)
    • values (array): At least two unique values to cycle through
    • isWorkspace (boolean, optional): Toggles the setting at the workspace level instead of globally (default: false)
    • disabledValue (any, optional): If the setting reaches this value (must be one of the values), the status bar icon will appear disabled/grayed out

Release Notes

See CHANGELOG.

Contributing

  1. Fork โ†’ Branch โ†’ Commit โ†’ Push โ†’ Open PR
  2. Found a bug? Open an Issue