diff --git a/docs/how-to-guides/create-write-tokens.md b/docs/how-to-guides/create-write-tokens.md
index 454ecf957..132cef3e8 100644
--- a/docs/how-to-guides/create-write-tokens.md
+++ b/docs/how-to-guides/create-write-tokens.md
@@ -12,12 +12,19 @@ You can create a write token by following these steps:
 1. Open the **Logfire** web interface at [logfire.pydantic.dev](https://logfire.pydantic.dev).
 2. Select your project from the **Projects** section on the left hand side of the page.
 3. Click on the ⚙️ **Settings** tab in the top right corner of the page.
-4. Select the **Write tokens** tab from the left hand menu.
-5. Click on the **New write token** button.
+4. Select the **Write tokens** tab from the left hand menu under **Developer Settings**.
+
+    ![Write Tokens page](../images/how-to-guides/write-tokens-page.png)
+
+5. Click on the **+ New write token** button. Fill in an optional description and expiration, then click **Create token**.
+
+    ![New write token form](../images/how-to-guides/write-tokens-new-form.png)
 
 After creating the write token, you'll see a dialog with the token value.
 **Copy this value and store it securely, it will not be shown again**.
 
+![Token created dialog](../images/how-to-guides/write-tokens-created.png)
+
 Now you can use this write token to send data to your **Logfire** project from any computer or application.
 
 We recommend you inject your write token via environment variables in your deployed application.
diff --git a/docs/images/how-to-guides/write-tokens-created.png b/docs/images/how-to-guides/write-tokens-created.png
new file mode 100644
index 000000000..9eb0de384
Binary files /dev/null and b/docs/images/how-to-guides/write-tokens-created.png differ
diff --git a/docs/images/how-to-guides/write-tokens-new-form.png b/docs/images/how-to-guides/write-tokens-new-form.png
new file mode 100644
index 000000000..f2c789134
Binary files /dev/null and b/docs/images/how-to-guides/write-tokens-new-form.png differ
diff --git a/docs/images/how-to-guides/write-tokens-page.png b/docs/images/how-to-guides/write-tokens-page.png
new file mode 100644
index 000000000..e559d4d59
Binary files /dev/null and b/docs/images/how-to-guides/write-tokens-page.png differ
diff --git a/docs/images/how-to-guides/write-tokens-settings.png b/docs/images/how-to-guides/write-tokens-settings.png
new file mode 100644
index 000000000..a003f5bac
Binary files /dev/null and b/docs/images/how-to-guides/write-tokens-settings.png differ