| title | User and Workspace Settings |
|---|---|
| titleSuffix | Azure Data Studio |
| description | How to customize Azure Data Studio by modifying User and Workspace Settings. |
| ms.custom | seodec18 |
| ms.date | 09/24/2018 |
| ms.prod | sql |
| ms.technology | azure-data-studio |
| ms.reviewer | alayu; sstein |
| ms.topic | conceptual |
| author | yualan |
| ms.author | alayu |
It is easy to configure [!INCLUDEname-sos] to your liking through settings. Nearly every part of [!INCLUDEname-sos]'s editor, user interface, and functional behavior has options you can modify.
[!INCLUDEname-sos] provides two different scopes for settings:
- User These settings apply globally to any instance of [!INCLUDEname-sos] you open.
- Workspace Workspace settings are settings specific to a folder on your computer, and are only available when the folder is open in the Explorer sidebar. Settings defined on this scope override the user scope.
The menu command File > Preferences > Settings (Code > Preferences > Settings on Mac) provides the entry point to configure user and workspace settings. You are provided with a list of Default Settings. Copy any setting that you want to change to the appropriate settings.json file. The tabs on the right let you switch quickly between the user and workspace settings files.
You can also open the user and workspace settings from the Command Palette (Ctrl+Shift+P) with Preferences: Open User Settings and Preferences: Open Workspace Settings or use the keyboard shortcut (Ctrl+,).
The following example disables line numbers in the editor and configures lines of code to be indented automatically.
Changes to settings are reloaded by [!INCLUDEname-sos] after the modified settings.json file is saved.
Note: Workspace settings are useful for sharing project-specific settings across a team.
Depending on your platform, the user settings file is located here:
- Windows
%APPDATA%\azuredatastudio\User\settings.json - Mac
$HOME/Library/Application Support/azuredatastudio/User/settings.json - Linux
$HOME/.config/azuredatastudio/User/settings.json
The workspace setting file is located under the .[!INCLUDE[name-sos](../includes/name-sos-short.md)] folder in your project.
Azure Data Studio remembers unsaved changes to files when you exit by default. This is the same as the hot exit feature in Visual Studio Code.
By default, hot exit is off. Enable hot exit by editing the files.hotExit setting. For details, see Hot Exit (in the Visual Studio Code documentation).
To simplify identifying what connections you are working with, open tabs in the editor can have their colors set to match the color of the Server Group the connection belongs to. By default, tab colors are off by default. Enable tab colors by editing the sql.tabColorMode setting.
Because [!INCLUDEname-sos] inherits its user and workspace settings functionality from Visual Studio Code, detailed information about settings is in the Settings for Visual Studio Code article.