Skip to main content
You can open a Gitpod workspace directly using a URL. The simplest way to start a workspace is by using the format: e.g. gitpod.io/#https://github.com/gitpod-io/empty. In addition to the repository, you can also specify overrides for:
  1. editor
  2. workspaceClass
  3. useLatest
Which is useful when integrating into a third party, or an internal developer portal.

​
URL Parameters

For the full list of available options in your installation, run the following Gitpod CLI commands: gitpod workspace list-classes gitpod workspace list-editors
If no URL parameter is specified, the users preferences or the organisation policies will take precedence.

​
URL Structure

The parameters specified in the URL must come before the # and the repo URL. For example: <gitpod-instance-url>?autostart=true&useLatest=true&<url-parameter>=<url-value>#<full-repo-url>

​
URL Examples

  • gitpod.io/?autostart=true&useLatest=true&editor=intellij#https://github.com/gitpod-io/empty
To open a workspace asking for confirmation before starting the workspace:
  • gitpod.io/?editor=code-desktop#https://github.com/gitpod-io/empty
To open a workspace without asking for confirmation:
  • gitpod.io/?autostart=true&editor=intellij#https://github.com/gitpod-io/empty
  • gitpod.io/?autostart=true&editor=code-desktop#https://github.com/gitpod-io/empty