diff --git a/docs/user-guides/user-secrets.md b/docs/user-guides/user-secrets.md
index 66c8e5dce7..7f2aca20af 100644
--- a/docs/user-guides/user-secrets.md
+++ b/docs/user-guides/user-secrets.md
@@ -106,10 +106,23 @@ These caps measure stored bytes, which is what Coder writes to the database.
 In deployments with secret encryption enabled, stored bytes exceed the raw
 value.
 
-## Create a secret
+## Manage secrets from the dashboard
 
-You can create, edit, and delete user secrets in the Coder dashboard. Click your
-avatar, select **Account**, then select **Secrets**.
+You can create, edit, and delete user secrets from the Coder dashboard:
+
+1. Click your avatar in the top right.
+1. Select **Account**.
+1. Select **Secrets**.
+
+From this page you can add a new secret, update an existing secret's value,
+description, or environment variable and file targets, and delete secrets you
+no longer need.
+
+The rest of this guide shows the equivalent CLI commands. The same behaviors,
+limits, and injection rules apply whether you manage secrets from the
+dashboard or the CLI.
+
+## Create a secret
 
 Use `coder secret create <name>` to create a user secret. For sensitive values,
 provide the value through non-interactive stdin with a pipe or redirect. This