Organization Secrets

Organization secrets are a type of secret scoped to the organization level. They are used to store sensitive data such as API keys, access tokens, and credentials which are shared across all environments in the organization.

Organization secrets have the lowest precedence in the secrets hierarchy. They can be overridden by both project secrets and user secrets with the same name. This makes them ideal for setting organization-wide defaults while still allowing projects and individual users to customize as needed.

To manage your organization secrets, navigate to the Settings > Organization > Secrets page in your Gitpod dashboard.

Secrets List

​

Secret Types

Organization secrets support the following types:

• Environment Variables
• Files
• Container Registry Secrets

​

Creating an Organization Secret

To create an organization secret, navigate to the Settings > Organization > Secrets page in your Gitpod dashboard and click the New Secret button.

​

Updating an Organization Secret

To update an organization secret, navigate to the Settings > Organization > Secrets page in your Gitpod dashboard and click the Edit button.

​

Deleting an Organization Secret

To delete an organization secret, navigate to the Settings > Organization > Secrets page in your Gitpod dashboard and click the Delete button next to the corresponding secret.