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

# Add and Manage Secrets

> How to create, edit, and delete secrets in your project.

## Add and Manage Secrets

Secrets are sensitive information, including passwords, API keys, database credentials, or any secure data used to access and protect resources in a software project.

You can create, manage, and access this data from the management dashboard.

<Note>
  A secret belongs to a single project within a workspace.
</Note>

### Create a new secret

1. Log in to your Locker Secrets Manager account, open a workspace and the project where you want to add a secret. You will be navigated to the **Secrets** screen.

2. Click the **New Secret** button in the upper right corner of the screen.

<img src="https://mintcdn.com/locker/RN2-OO7uarVxuthM/images/en/locker-secrets-manager/secrets-management/secret-list.png?fit=max&auto=format&n=RN2-OO7uarVxuthM&q=85&s=1081234766f2d86ff1cfd1bb45ac5029" alt="Secrets list screen with the New Secret button" width="1920" height="525" data-path="images/en/locker-secrets-manager/secrets-management/secret-list.png" />

3. Enter the key and value for the secret you want to create. You can add a description if desired.

<img src="https://mintcdn.com/locker/RN2-OO7uarVxuthM/images/en/locker-secrets-manager/secrets-management/secret-create-form.png?fit=max&auto=format&n=RN2-OO7uarVxuthM&q=85&s=a50bd2639ca39e6a2a7338b58821a136" alt="New secret creation form" width="512" height="737" data-path="images/en/locker-secrets-manager/secrets-management/secret-create-form.png" />

4. Select an environment where the secret will be deployed. You can choose an existing environment or create a new one.

   The default environment value is `All (*)`, which means the created secret will be deployed across all environments in your project.

   <Note>
     You cannot create two or more secrets with the same key in the same environment. Each secret's key must be unique within an environment.
   </Note>

5. Click the **Create** button. You will see the newly created secret appear in the list.

<img src="https://mintcdn.com/locker/RN2-OO7uarVxuthM/images/en/locker-secrets-manager/secrets-management/secret-created-list.png?fit=max&auto=format&n=RN2-OO7uarVxuthM&q=85&s=ea20925cc9bdfb29f9f8c0a629adb6d1" alt="Secrets list after creation" width="1920" height="625" data-path="images/en/locker-secrets-manager/secrets-management/secret-created-list.png" />

### Edit a secret

To edit a secret, go to the **Secrets** screen.

1. Click the **Pencil** icon corresponding to the secret you want to edit.

<img src="https://mintcdn.com/locker/RN2-OO7uarVxuthM/images/en/locker-secrets-manager/secrets-management/secret-edit-icon.png?fit=max&auto=format&n=RN2-OO7uarVxuthM&q=85&s=81cfe40f05e79d4e8184543c91bc2b03" alt="Secrets list with the edit icon" width="1920" height="775" data-path="images/en/locker-secrets-manager/secrets-management/secret-edit-icon.png" />

2. Edit the key, value, description, or environment fields of the secret as desired.
3. Click the **Save** button to save your changes.

### Delete a secret

To delete a secret, go to the **Secrets** screen.

1. Click the **Trash** icon corresponding to the secret you want to delete.

<img src="https://mintcdn.com/locker/RN2-OO7uarVxuthM/images/en/locker-secrets-manager/secrets-management/secret-delete-icon.png?fit=max&auto=format&n=RN2-OO7uarVxuthM&q=85&s=0ca22a679b8a003c69869aef2c76c233" alt="Secrets list with the delete icon" width="1920" height="682" data-path="images/en/locker-secrets-manager/secrets-management/secret-delete-icon.png" />

2. In the pop-up window that appears, click the **Confirm** button to delete the secret.
3. The secret will be permanently deleted.
