> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blocks.team/llms.txt
> Use this file to discover all available pages before exploring further.

# Environment Variables

> Manage secrets and configuration available to coding agents at runtime

## Overview

Environment variables let you provide secrets, API keys, and configuration values to coding agents without hardcoding them in your repositories. Variables are stored securely and injected into the agent sandbox at runtime.

Manage them at **Dashboard → Settings → Environment Variables**.

## Scoping variables

Variables can be scoped **globally** (available in every session) or to a **specific repository** (only available when that repo is active). Use the namespace selector at the top of the page to switch between global and per-repo scopes when creating or viewing variables.

Use per-repo scoping when different repositories need different values for the same key — for example, separate database URLs for different services.

## Adding variables

**Single variable** — click **Add**, enter a name and value, and save.

**Bulk import** — switch to the **Bulk** tab and paste multiple `KEY=VALUE` pairs, one per line. Lines starting with `#` are treated as comments. You'll see a confirmation showing which variables will be created and which will be updated before anything is saved.

Variable names must be alphanumeric with underscores only (max 100 characters). Values are masked after saving and never displayed in plaintext.

## Editing and deleting

Click any variable row to open the edit dialog. Use the eye icon to reveal the current value. To delete, open the three-dot menu and select **Delete** — you'll be asked to confirm before anything is removed.