> ## 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](/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, click the **Add Secret** button at the top of the dashboard.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/add-secret-2.png" alt="Add Secret button at the top of the secrets dashboard" />

For a new project, it can be convenient to populate the dashboard by dropping a `.env` file into the provided pane as shown below:

<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 and click the three dots on the right side, then select **Delete secret** from the dropdown.

<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 with Delete secret option visible" />

To delete multiple secrets at once, hover over and select the secrets you'd like to delete
and click the **Delete** button that appears at the top.

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

### Search

To search for specific secrets by their key name, you can use the search bar.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/search-secrets-2.png" alt="Search bar at the top of the secrets dashboard" />

To assist you with finding secrets, you can also group them by similar prefixes and filter them by tags (if applicable).

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/filter-secrets-2.png" alt="Filter dropdown showing grouping by prefix and tag options" />

### Reveal values

To view all secret values at once, toggle the **Reveal values** button.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/reveal-values-2.png" alt="Reveal values button on the secrets dashboard" />

### Download as .env

To download/export secrets back into a `.env` file, click the download button.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/download-env-2.png" alt="Download button for exporting secrets as a .env file" />

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 better organize similar secrets, hover over them and label them with a tag.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/tags-2.png" alt="Tag selector appearing on hover over a secret" />

### Comments

To provide more context about a given secret, especially for your team, hover over it and click the comment button.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/comment-2.png" alt="Comment button appearing on hover over 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.

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

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/project/override-2.png" alt="Secret row showing the personal override option" />
