Skip to main content

1Password Environments Beta

1Password Environments allow you to organize and manage your project's environment variables, separately from the rest of the items in your 1Password vaults. You can create an Environment for each project or development stage, then securely access your variables directly from 1Password when you need them. With Environments, you can:

You can import your project variables to Environments from your existing .env files, or by manually adding key-value pairs for each variable.

A 1Password Environment with several environment variables added to it.A 1Password Environment with several environment variables added to it.
caution

When sharing an Environment with others and reading its contents outside of 1Password, review the Environment's values carefully before using them in any program or workflow. What you store in 1Password is exactly what we provide when you read your Environment.

Requirements​

Before you can use Environments, you'll need to:

Turn on 1Password Developer​

  1. Open and unlock the 1Password desktop app.
  2. Select your account or collection at the top of the sidebar, then select Settings > Developer.
  3. Turn on Show 1Password Developer experience.

Create an Environment​

  1. In the 1Password desktop app, go to Developer > View Environments.
  2. Select New environment.
  3. Enter a name for the new environment, then select Save. If you have multiple 1Password accounts, you can select which account to save the Environment to.

Add variables to an Environment​

After you create an Environment, you can add your project secrets as variables. 1Password Environment variables map to conventional environment variables . Each variable is a key-value pair that includes a name (for example, DB_HOST, DB_USER, or API_KEY) and a value that holds the corresponding secret.

To add variables to an Environment, open and unlock the 1Password desktop app, navigate to Developer > View Environments, then select the Environment you want to update.

You can add variables in two ways:

  • If you have an existing .env file for your project, select Import .env file. 1Password will automatically import your environment variables.
  • To manually add environment variables, select New variable. Enter the environment variable name in the Name field and its secret in the Value field. Repeat this process for each environment variable you want to add.
note

Values are hidden by default, which means they'll be masked in the output of CLI and SDK operations. To change this, select the verticle ellipsis next to the variable, then select Show value by default.

You can add, edit, or remove variables from your Environment at any time. To update your variables, open the Environment and select Edit.

Use your Environments in your workflows​

In the 1Password desktop app, each Environment has a tab called Destinations where you can configure your Environment to use in your workflows. The following destinations are available:

  • Local .env file: Create a locally mounted .env file to make your environment variables available during local development without writing plaintext secrets to disk.
  • Cursor Agent: Use 1Password's Cursor Hook to validate your locally mounted .env files before Cursor Agent executes shell commands.
  • Programatically read Environments: Read environments then pass environment variables to applications and scripts using 1Password CLI or 1Password SDKs.
  • AWS Secrets Manager: Sync secrets from 1Password to AWS Secrets Manager.

Manage your Environments​

tip

1Password Environments return values exactly as they are entered. Format your values as you would in a standard .env file. For example:

  • If a value contains a space, enclose the value in quotation marks: "bar baz"
  • If a value contains special characters, escape them with a \: \$100

Values are hidden by default, but you can toggle the visibility on or off in the Actions column. You can also delete variables from this column. Select Edit within the environment to add, edit, or delete variables at a later time.

Rename or remove an Environment​

If you want to rename or remove an Environment:

  1. In the 1Password desktop app, go to Developer > View Environments.
  2. Select the Environment you want to manage, then select Manage Environment.
  3. Choose Rename environment or Delete environment.
caution

Deleted Environments cannot be restored and any associated integrations will stop working. 1Password will prompt you to confirm whether or not you want to delete your Environment before proceeding.

Share an Environment​

If you're using a shared account, such as for a team or business, you can share Environments with your team members. Each Environment remains independent, allowing you to work across multiple environments in different accounts while keeping environment variables separate. Access must be granted for each Environment.

To share an Environment:

  1. In the 1Password desktop app, go to Developer > View Environments.
  2. Select the Environment you want to share, then select Manage environment > Manage access.
  3. Select Add People, then search for and select the team member you want to add to the Environment. Select Next.
  4. Select View & Edit, and choose whether the person can view, edit, or manage the Environment.

To remove a team member from an Environment, return to the "Manage access" screen and select Remove from environment next to the person's name.

Learn more​

Was this page helpful?