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

# Projects

> Learn about Infisical projects and how to manage secrets across environments.

A secrets management project in Infisical is a dedicated workspace for managing application secrets such as API keys, database credentials, configuration, etc. used by your applications.

Secrets are organized into a clear hierarchy of environments, folders, and individual secrets, making it easy to manage values across different stages of your development lifecycle (e.g., development, staging, production).

The short video below walks through Infisical projects, covering how secrets are organized into environments and folders, and the dashboard features available to manage them.

<br />

<div style={{ position: "relative", paddingBottom: "56.25%", height: 0, overflow: "hidden", maxWidth: "100%" }}>
  <iframe src="https://www.youtube.com/embed/3dPwEhCU00E" title="YouTube video player" style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />
</div>

<br />

## Project environments

Infisical lets you split secrets into environments (e.g., development, staging, production) for both visual and organizational structure. You can customize environments in project settings.

The short video below walks through how to use environments in Infisical.

<br />

<div style={{ position: "relative", paddingBottom: "56.25%", height: 0, overflow: "hidden", maxWidth: "100%" }}>
  <iframe src="https://www.youtube.com/embed/9foN4T3VP-s" title="YouTube video player" style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />
</div>

<br />

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/project-environments.png" alt="Project settings page showing configured environments" />

## Secrets overview

The **Secrets Overview** page captures a bird's-eye view of secrets and [folders](/docs/documentation/platform/folder) across environments.
This is useful for comparing secrets, identifying if anything is missing, and making quick changes.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/secrets-overview-2.png" alt="Secrets overview page showing secrets across all environments" />

## Secrets dashboard

The **Secrets Dashboard** page appears when you select a specific environment to manage its secrets.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/secrets-dashboard-2.png" alt="Secrets dashboard showing environment secrets" />

### Secrets

To add a secret, select **Add Secret** at the top of the dashboard.

In a new project, you can fill the dashboard in one go by dropping a `.env`, `.json`, `.yml`, or `.csv` file onto the upload pane:

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/drop-env-2.png" alt="Dashboard showing drag-and-drop pane for importing a .env file" />

To delete a secret, hover over it, select the three dot menu on the right, then select **Delete Secret**.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/delete-secret-2.png" alt="Three dot menu open on a secret row, showing Delete Secret" />

To delete several secrets at once, select their checkboxes, then select **Delete** at the top.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/delete-multiple-2.png" alt="Three secrets selected with the Delete button at the top of the dashboard" />

### Search

To find a secret by name, type into the search bar.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/search-secrets-2.png" alt="Secrets dashboard filtered by a search term" />

Select the filter icon to narrow the list to one kind of resource, or to filter by tag. The resource types are folders, secrets, secret imports, secret rotations, dynamic secrets, honey tokens, and proxied services.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/filter-secrets-2.png" alt="Filter by Resource menu open on the secrets dashboard" />

### Reveal values

To show every value at once, select **Reveal Values**.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/reveal-values-2.png" alt="Secrets dashboard with every value revealed" />

### Download as .env

To export the secrets in the current folder as a `.env` file, select the download icon.

The short video below walks through tagging, comments, and personal overrides, three ways to organize, annotate, and customize secrets in the dashboard.

<br />

<div style={{ position: "relative", paddingBottom: "56.25%", height: 0, overflow: "hidden", maxWidth: "100%" }}>
  <iframe src="https://www.youtube.com/embed/bhprcVcIPMs" title="YouTube video player" style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />
</div>

<br />

### Tags

To group similar secrets, hover over a secret, select the three dot menu, then select **Annotate** and **Add Tags**.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/tags-2.png" alt="Annotate menu expanded on a secret row, showing Add Tags" />

### Comments

To leave context for your team, hover over a secret and select the comment icon.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/comment-2.png" alt="Comment dialog open for a secret" />

### Personal overrides

Infisical employs the concept of **shared** and **personal** secrets to address the need
for common and custom secret values, or branching, amongst members of a team during software development.
To provide a helpful analogy: a shared value is to a `main` branch as a personal value is to a custom branch.

Consider:

* A team with users A, B, and C.
* A project with an environment containing a shared secret called D with the value E.

Suppose user A overrides the value of secret D with the value F.

Then:

* If user A fetches secret D, they get the value F.
* If users B and C fetch secret D, they both get the value E.

To set a personal value, hover over the secret, select the three dot menu, then select **Add Override**.

<Info>
  Secret reminders don't work with personal overrides.
</Info>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.