Still, you may wish to customize Gitpod, or to extend it with new features. You can do this by installing VS Code extensions.
To install a VS Code extension in Gitpod, simply go to the left vertical menu, and open the Extensions view. There you can search for an extension and install it with one click.
If the extension is helpful to anyone who works on the project, you can add it to the
.gitpod.yml configuration file so that it gets installed for anyone who works on the project. To do that:
- Visit the extension page (where you installed it from)
- Click the settings icon
- Select “Add to .gitpod.yml” from the menu
.gitpod.yml is updated automatically and lists the given extension. You can also directly edit this file to install or remove extensions manually.
Here is an example of what a
.gitpod.yml with installed extensions may look like:
vscode: extensions: - svelte.svelte-vscode - email@example.com - https://example.com/abc/releases/extension-0.26.0.vsix
You can share the installed extensions with your team by committing the
.gitpod.yml change and pushing it to your Git repository.
Extensions are installed in the
You have two options to install extensions for yourself only:
- For the current workspace only - if you don’t want extensions to be synced across workspaces, select
Install (Do Not Sync)instead of
Installwhen installing new extensions.
- For all your workspaces - can be useful for extensions that you want to have in all your projects (for example a custom theme), and this doesn’t require changing every project’s
.gitpod.ymlconfiguration. All manually installed extensions are synced across workspaces by default.
You can read more about why and how extensions are synced on the Settings Sync page.
Gitpod already comes with a number of commonly used VS Code extensions pre-installed by default.
You can view all pre-installed extensions by navigating to VS Code’s Extensions section on the left-hand side. In the “Search Extensions in Marketplace” input field, type
@builtin to see the built-in extensions.
In that case, please reach out to the extension author and politely ask them to publish their extension to the vendor-neutral, open source Open VSX registry. The ”How to Publish an Extension” docs provide step-by-step instructions.
Please note that
.vsix files downloaded from the Visual Studio Marketplace should not be installed in Gitpod, because Microsoft prohibits the direct use of their marketplace by any non-Microsoft software, even though most extensions are actually open source and not developed or maintained by Microsoft.
You can also develop and install your own extensions. Note that installing a
.vsix file in Gitpod will not list that extension anywhere publicly except in your own
.gitpod.yml, so you can also install private extensions that way.