Profiles in Visual Studio Code
AI agents: See llms.txt for documentation discovery and navigation. Documentation articles are also available as Markdown by appending .md to the article URL. 🎬 Watch The Story of VS Code! VS Code is now on Instagram, follow @vscode.ig for updates, tips, and more. Rewatch GitHub Copilot Day. Profiles in Visual Studio Code View as Markdown Ask in VS Code Ask in VS Code Insiders Visual Studio Code has hundreds of settings , thousands of extensions , and innumerable ways to adjust the UI layout to customize the editor.
VS Code Profiles let you create sets of customizations and quickly switch between them or share them with others. This topic explains how to create, modify, export, and import profiles by using the Profiles editor . Access the Profiles editor The Profiles editor enables you to create and manage your profiles in VS Code from a single place. The Profiles editor opens by default in a modal overlay on top of the editor area.
You can access the Profiles editor in either of the following ways: From the File > Preferences > Profiles menu item From the Manage gear button in the bottom of the Activity Bar. Create a Profile VS Code treats your current configuration as the Default Profile . As you modify settings, install extensions, or change UI layout by moving views, these customizations are tracked in the Default Profile. To create a new profile, open the Profiles editor and select the New Profile button.
This opens the New Profile form, where you can enter a profile name, choose an icon, and configure the contents that are included in the new profile. You can choose to either create a new profile by copying the contents from a Profile Template or from an existing profile, or to create an Empty Profile . An Empty Profile includes no user customizations, such as settings, extensions, snippets, etcetera. You can limit the new profile to only include a subset of configurations (settings, keyboard shortcuts, MCP servers, snippets, tasks and extensions) and use the rest of the configurations from the Default Profile.
For example, you can create a profile with all configurations, except for keyboard shortcuts, and VS Code will apply the keyboard shortcuts from the Default Profile when this profile is active. You can browse the contents of the template or profile you are copying from in the Contents section. There is an Open button next to each section that you can select to see its contents. Preview the new profile before creating it by selecting the Preview button.
This opens a new VS Code window with the new profile applied to it. Once you are happy with the preview, you can select the Create button to create the new profile. Check the current profile You can find the profile that is currently in use by the VS Code window in several places in the VS Code UI: In the VS Code title bar In the hover text when you hover over the Manage button in the Activity Bar If you have configured an icon for the profile, this icon is used as the Manage button in the Activity Bar.
Notice in the following screenshot that the Manage button now has a microphone icon, indicating that a profile is active. If you have not configured an icon, then the Manage gear button displays a badge with the first two letters of the active profile so you can quickly check which profile you are running. In the Profiles editor Note : If you are using the Default Profile, no profile name is displayed. Configure a profile You can configure a profile just as you would change any VS Code configuration.
You can install/uninstall/disable extensions, change settings, and adjust the editor's UI layout (for example, moving and hiding views). As you apply these changes, they are then stored in your currently active profile. Folder & workspace associations When you create or select a profile, it is associated with the current folder or workspace. Whenever you open that folder, the workspace's profile becomes active. If you open another folder, the profile changes to that of the other folder, if one was already set.
You can view the list of folders that are associated with a profile in the Folders & Workspaces section of the Profiles editor . Manage profiles Switch profiles You can quickly switch between profiles with the Profiles: Switch Profile command in the Command Palette, which presents a dropdown listing your available profiles. You can also switch profiles from the Profiles editor by selecting the Use this Profile for Current Window button next to the profile you want to switch to.
Edit a profile You can edit the name, icon, and other configurations of an existing profile in the Profiles editor . Delete a profile You can delete a profile from the Profiles editor by selecting the Delete Profile button in the overflow actions of the profile you want to delete. You can also delete a profile via the Delete Profile command. The Delete Profile dropdown lets you select which profile(s) to delete. Open a new window with a profile You can choose a profile to use when you open a new VS Code window by using Use for New Windows option that is available in the Profile Content view in the Profiles editor.
You can directly open a new VS Code window for a specific profile by using the File > New Window with Profile menu, and selecting the profile you want to use. Apply a setting to all profiles To apply a setting across all your profiles, use the Apply Setting to all Profiles action in the Settings editor. Updates to this setting from within any of your profiles are also applied to all other profiles. You can always revert this behavior by unchecking the Apply Setting to all Profiles action.
Apply an extension to all profiles To apply an extension across all your profiles, select the Apply Extension to all Profiles action in the Extensions view. This makes this extension available in all your profiles. You can always revert this behavior by unchecking the Apply Extension to all Profiles action. Synchronize profiles across machines You can use Settings Sync to move your profiles across various machines. With Setting Sync enabled and Profiles checked in the Settings Sync: Configure drop down, all your profiles are available on the synced machines.
Note : VS Code does not synchronize your extensions to or from a remote window, such as when you're connected to SSH, a development container (devcontainer), or WSL. Share Profiles Export You can export a profile for saving it or sharing it with others by using the Export... button in the overflow actions of the profile you want to export. When you select Export... , you are prompted for the profile name and whether you want to export to either a GitHub gist or to your local file system.
Save as a GitHub gist After you save a profile to GitHub (you'll be prompted to log into GitHub), a dialog gives you the option to Copy Link for sharing your profile gist URL with others. The URL includes an autogenerated GUID and has the format https://vscode.dev/editor/profile/github/{GUID} . The GitHub gist is marked as Secret , so only those with the link can see the gist. If you launch the profile URL, it opens VS Code for the Web with the Profiles editor open and the imported profile contents displayed.
You can unselect profile elements if you wish, and you need to manually Install Extensions (via the download cloud button) if you want to continue using that profile in VS Code for the Web . You also have the option to Import Profile in Visual Studio Code , which opens VS Code Desktop with the profile's contents displayed and an Import Profile button. You can review your gists at https://gist.github.com/{username} . From your GitHub gist page, you can rename, delete, or copy the GUID of a gist.
Save as a local file If you chose to save the profile as a local file, a Save Profile dialog lets you place the file on your local machine. A profile is persisted in a file with the extension .code-profile . Import You can import an existing profile from the Profiles editor by select
The rest of this page is on the live site.