Environment Variables

Environment variables are variables that are scoped to an environment, such as local development or production. They are useful for storing variables that can be re-used across the collection that are different depending on the environment. An example would be the host url of the server you want to test.

Creating an Environment Variable

Go to environments (top right) and press No environment.
If there are no environments, you will be prompted to create one.

Add your variable name, value, and an optional description for what the variable represents.
Save your changes.

Using an Environment Variable

Just like other variables you can use the {{varName}} syntax to use an environment variable in a request. On the top-right, you can see which environment you are currently using and select a different one.

Searching environment variables

When working with a large number of environment variables, you can use the search feature to quickly find specific variables.

Open your environment settings.
Click the search icon in the environment details panel.
Type your query to filter variables by name or value.

The search filters the variable list in real time. If you click on a variable row while searching, that row stays visible even if it no longer matches the query, so you can edit it without losing your place. The row unpins automatically after a short delay.

The search feature is also available for global environment variables.

Default environment

You can set a default environment for a collection so teammates and new sessions start with the right environment selected, without picking it manually every time. The default is stored in the collection > Presets and travels with the collection when you share, export, or import it.

Set a default environment

Go to Collection > Presets tab.
Select the collection environment you want as the default
Click Save button.

Bruno marks that environment as the collection default and saves it to the collection config.

How the default is applied

Situation	What Bruno uses
You open a collection and already have a recently selected environment saved in the UI snapshot	The saved selection (default does not override it)
You open or import a collection with no recent environment selected	The configured default environment
You run requests in the app with no environment selected	The default environment, if one is configured
You run the collection with Bruno CLI and omit `--env`	The collection’s default environment, if one is configured

The default environment is shareable with the collection. Setting it updates collection config (bruno.json or OpenCollection YAML), not only your local UI state.

Persistence and export

The default environment is persisted in the collection configuration and included when you export the collection:

Bruno native - stored in bruno.json
OpenCollection YAML - stored in opencollection.yml

On import or when opening a collection, if no recent environment is selected from the UI snapshot, Bruno falls back to this configured default.

Example config

After you set Local as the default, the collection config includes that choice. Exact field placement depends on format:

Bru Collections
OpenCollection YAML

bruno.json

{
  "version": "1",
  "name": "my-api",
  "defaultEnvironment": "Local"
}

opencollection.yml

opencollection: 1.0.0
info:
  name: my-api
extensions:
  bruno:
    defaultEnvironment: Local

Using the ./environment directory

Environment variables are synced with the /environments directory inside your collection. You can also create and manage environments there. Each environment is saved in a <environment-name>.bru file or a .yml file depending on the format in use. BRU format (local.bru)

vars {
  @description('''Base URL for the local server''')
  host: http://localhost:8787

  @description('''
    JWT token obtained after login.
    Expires in 24 hours.
  ''')
  token: abc123

  noDesc: plain-value
}

Use @description before a variable to document what it represents. Descriptions are optional, always go on the line immediately before the variable, and support multiline text using triple quotes ('''). YAML format (production.yml)

name: Production
variables:
  - name: host
    value: https://api.example.com
    enabled: true
    secret: false
    description: Single-line description

  - name: token
    value: abc123
    enabled: true
    secret: false
    description: |-
      Multiline description.
      Supports multiple lines.
      Third line here.

  - name: apiKey
    value: ''
    enabled: true
    secret: true
    description: Secret API key stored encrypted

  - name: disabledVar
    value: old-value
    enabled: false
    secret: false
    description: This variable is disabled

  - name: ''
    value: ''
    enabled: true
    secret: false
    description: Orphaned description becomes an empty-name row

The description field is optional. Use the block scalar |- for multiline descriptions to preserve line breaks. A variable with an empty name and value is treated as an orphaned description row in the UI.

For information on importing and exporting environment variables, see the Import/Export Environments guide.

Overview

Send Requests

Variables

Authentication

Secret Management

Tests

Scripts

Git & Collaboration

AI

Apps

Settings

Debugging

Environment Variables

Creating an Environment Variable

Using an Environment Variable

Searching environment variables

Default environment

Set a default environment

How the default is applied

Persistence and export

Example config

Using the ./environment directory

​Creating an Environment Variable

​Using an Environment Variable

​Searching environment variables

​Default environment

​Set a default environment

​How the default is applied

​Persistence and export

​Example config

​Using the ./environment directory

Creating an Environment Variable

Using an Environment Variable

Searching environment variables

Default environment

Set a default environment

How the default is applied

Persistence and export

Example config

Using the ./environment directory