diff --git a/website/content/docs/auth/userpass.mdx b/website/content/docs/auth/userpass.mdx
index 69cc57e8e7ae..f168ffaabb17 100644
--- a/website/content/docs/auth/userpass.mdx
+++ b/website/content/docs/auth/userpass.mdx
@@ -65,14 +65,20 @@ management tool.
 
 1. Enable the userpass auth method:
 
-   ```text
+   ```shell-session
    $ vault auth enable userpass
    ```
+   
+   This enables the userpass auth method at `auth/userpass`. To enable it at a different path, use the `-path` flag:
+   
+   ```shell-session
+   $ vault auth enable -path=<path> userpass
+   ```
 
 1. Configure it with users that are allowed to authenticate:
 
-   ```text
-   $ vault write auth/userpass/users/mitchellh \
+   ```shell-session
+   $ vault write auth/<userpass:path>/users/mitchellh \
        password=foo \
        policies=admins
    ```
@@ -81,6 +87,7 @@ management tool.
    associated with the "admins" policy. This is the only configuration
    necessary.
 
+
 ## API
 
 The Userpass auth method has a full HTTP API. Please see the [Userpass auth