diff --git a/docs/content/how-to/ci/docs-preview.md b/docs/content/how-to/ci/docs-preview.md
index 0a82bc70de5..7758adfad15 100644
--- a/docs/content/how-to/ci/docs-preview.md
+++ b/docs/content/how-to/ci/docs-preview.md
@@ -11,7 +11,7 @@ The preview system uses two separate workflows for security, following the reusa
 
 GitHub shows a **View deployment** link in the PR timeline via the `docs-preview` environment.
 
-The preview is available at `https://pr-<number>.hypershift.pages.dev`.
+The preview is available at `https://pr-<number>.hypershift.pages.dev`. Previews are automatically cleaned up by Cloudflare's branch retention policy.
 
 ## Configuration
 
@@ -24,6 +24,10 @@ The deploy workflow requires two secrets configured on the `docs-preview` GitHub
 | `CLOUDFLARE_ACCOUNT_ID` | Cloudflare account ID |
 | `CLOUDFLARE_API_TOKEN` | API token with Cloudflare Pages edit permissions |
 
+## Troubleshooting
+
+If the preview link doesn't appear on your PR, check that the Docs Build workflow completed successfully. The Docs Deploy workflow triggers automatically after a successful build.
+
 ## Local Preview
 
 To preview documentation locally: