diff --git a/docs/my-website/docs/secret_managers/hashicorp_vault.md b/docs/my-website/docs/secret_managers/hashicorp_vault.md
index c5082ce7fb..e9e0116f4f 100644
--- a/docs/my-website/docs/secret_managers/hashicorp_vault.md
+++ b/docs/my-website/docs/secret_managers/hashicorp_vault.md
@@ -198,10 +198,13 @@ LiteLLM stores secret under the `prefix_for_stored_virtual_keys` path (default:
-### Team-specific overrides (proxy)
+### Team-specific overrides
-When running the LiteLLM proxy you can override the Vault location per team. Set
-`Secret Manager Settings` on the team with the following structure:
+When running the LiteLLM proxy you can override the Vault location per team. Use the [Team-Level Secret Manager Settings](./overview.md#team-level-secret-manager-settings) flow in the dashboard and configure the panel shown below:
+
+
+
+Use the following structure for the JSON payload:
```json
{
diff --git a/docs/my-website/docs/secret_managers/overview.md b/docs/my-website/docs/secret_managers/overview.md
index 957e7dc0a0..a987c72d76 100644
--- a/docs/my-website/docs/secret_managers/overview.md
+++ b/docs/my-website/docs/secret_managers/overview.md
@@ -49,9 +49,28 @@ general_settings:
## Team-Level Secret Manager Settings
-From the **Teams** page in the LiteLLM dashboard you can configure a secret manager per team. Open the team (or the “Create New Team” modal), find the **Secret Manager Settings** panel, and enter the provider-specific JSON configuration (e.g. `{"namespace": "admin", "mount": "secret", "path_prefix": "litellm"}`). This configuration is applied whenever LiteLLM writes secrets (e.g., storing virtual keys) on behalf of that team.
+Team-level secret manager settings let every team bring their own key-management configuration. These settings are used when creating virtual keys tied to the team.
-
+Follow these steps to configure it:
+1. **Create a team**
+ Open the Teams page and click `Create Team` to launch the modal.
-Refer to each provider’s documentation (AWS, Azure, Google, Hashicorp, etc.) for the supported keys/values you can place inside `secret_manager_settings`.
+
+
+2. **Expand Additional Settings**
+ Use the `Additional Settings` toggle to reveal the advanced configuration panel.
+
+
+
+3. **Configure the Secret Manager**
+ In the `Secret Manager Settings` panel, paste the provider-specific JSON. Refer to each provider page (AWS, Azure, Google, Hashicorp, etc.) for the supported keys/values. JSON is required today, but we plan to add a more UI-friendly editor.
+
+
+
+4. **Create the team**
+ Review the inputs and click `Create Team` to save.
+
+
+
+Once saved, LiteLLM will use this configuration.
diff --git a/docs/my-website/img/secret_manager_hashicorp_vault_settings.png b/docs/my-website/img/secret_manager_hashicorp_vault_settings.png
new file mode 100644
index 0000000000..c471480a3b
Binary files /dev/null and b/docs/my-website/img/secret_manager_hashicorp_vault_settings.png differ
diff --git a/docs/my-website/img/secret_manager_settings.png b/docs/my-website/img/secret_manager_settings.png
index ce13a60ee9..4b01dd4320 100644
Binary files a/docs/my-website/img/secret_manager_settings.png and b/docs/my-website/img/secret_manager_settings.png differ
diff --git a/docs/my-website/img/secret_manager_settings_additional_settings.png b/docs/my-website/img/secret_manager_settings_additional_settings.png
new file mode 100644
index 0000000000..713031cb5c
Binary files /dev/null and b/docs/my-website/img/secret_manager_settings_additional_settings.png differ
diff --git a/docs/my-website/img/secret_manager_settings_create_button.png b/docs/my-website/img/secret_manager_settings_create_button.png
new file mode 100644
index 0000000000..5c08eae893
Binary files /dev/null and b/docs/my-website/img/secret_manager_settings_create_button.png differ
diff --git a/docs/my-website/img/secret_manager_settings_create_team.png b/docs/my-website/img/secret_manager_settings_create_team.png
new file mode 100644
index 0000000000..b6bd18e428
Binary files /dev/null and b/docs/my-website/img/secret_manager_settings_create_team.png differ