docs/documentation/platform/secrets-mgmt/project.mdx
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 — how secrets are organized into environments, folders, and the dashboard features available to manage them.
<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 ></iframe> </div>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 Secrets Overview page captures a bird's-eye view of secrets and folders across environments. This is useful for comparing secrets, identifying if anything is missing, and making quick changes.
The Secrets Dashboard page appears when you select a specific environment to manage its secrets.
To add a secret, click the Add Secret button at the top of the 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:
To delete a secret, hover over it and click the three dots on the right side, then select Delete secret from the dropdown.
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.
To search for specific secrets by their key name, you can use the search bar.
To assist you with finding secrets, you can also group them by similar prefixes and filter them by tags (if applicable).
To view all secret values at once, toggle the Reveal values button.
To download/export secrets back into a .env file, click the download button.
To better organize similar secrets, hover over them and label them with a tag.
To provide more context about a given secret, especially for your team, hover over it and click the comment button.
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:
Suppose user A overrides the value of secret D with the value F.
Then: