diff --git a/fern/products/docs/pages/changelog/2026-03-09.mdx b/fern/products/docs/pages/changelog/2026-03-09.mdx
new file mode 100644
index 0000000000..df9b1c00d3
--- /dev/null
+++ b/fern/products/docs/pages/changelog/2026-03-09.mdx
@@ -0,0 +1,18 @@
+---
+tags: ["local-development", "configuration"]
+---
+
+## Preview workflow with direct page links
+
+You can now use an updated GitHub Actions preview workflow that comments on your pull request with direct links to every page you changed, so reviewers can jump straight to affected pages without navigating through the full site. The comment updates with a new preview link and refreshed page links when you push new commits.
+
+
+
+
+
+To adopt this workflow, replace your `.github/workflows/preview-docs.yml` with the updated version. New sites created through the [guided UI](https://dashboard.buildwithfern.com/get-started) or [CLI quickstart](/learn/docs/getting-started/quickstart) include it automatically.
+
+
diff --git a/fern/products/docs/pages/getting-started/images/markdown-links-preview.png b/fern/products/docs/pages/getting-started/images/markdown-links-preview.png
new file mode 100644
index 0000000000..c1b923c9dd
Binary files /dev/null and b/fern/products/docs/pages/getting-started/images/markdown-links-preview.png differ
diff --git a/fern/products/docs/pages/getting-started/preview-changes-locally.mdx b/fern/products/docs/pages/getting-started/preview-changes-locally.mdx
index 0378ef8746..59e5094890 100644
--- a/fern/products/docs/pages/getting-started/preview-changes-locally.mdx
+++ b/fern/products/docs/pages/getting-started/preview-changes-locally.mdx
@@ -62,7 +62,16 @@ fern docs preview delete
### Automate with GitHub Actions
-If you set up your site using the [guided UI](https://dashboard.buildwithfern.com/get-started) or [CLI quickstart](/learn/docs/getting-started/quickstart), preview workflow files are automatically included in your repository. Otherwise, add them manually using the examples below.
+You can use a GitHub Actions workflow to automatically generate a preview URL when a pull request is opened. The workflow posts a comment on the PR with the preview link and direct links to every page changed in the PR, so reviewers can jump straight to affected pages. When you push new commits, the comment is updated with a new preview link and refreshed page links.
+
+
+
+
+
+If you set up your site using the [guided UI](https://dashboard.buildwithfern.com/get-started) or [CLI quickstart](/learn/docs/getting-started/quickstart), this workflow is automatically included in your repository. Otherwise, add it manually using the examples below.
These workflows require a `FERN_TOKEN` [repository secret](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions#creating-secrets-for-a-repository). If you used the guided workflow, this secret is added automatically. Otherwise, run [`fern token`](/learn/cli-api-reference/cli-reference/commands#fern-token) in your terminal to generate a token, then add it in your repository's **Settings > Secrets and variables > Actions** with the name `FERN_TOKEN`.
+
+
+To adopt this workflow, replace your `.github/workflows/preview-docs.yml` with the updated version. New sites created through the [guided UI](https://dashboard.buildwithfern.com/get-started) or [CLI quickstart](/learn/docs/getting-started/quickstart) include it automatically.
+
+
diff --git a/fern/products/docs/pages/getting-started/images/markdown-links-preview.png b/fern/products/docs/pages/getting-started/images/markdown-links-preview.png
new file mode 100644
index 0000000000..c1b923c9dd
Binary files /dev/null and b/fern/products/docs/pages/getting-started/images/markdown-links-preview.png differ
diff --git a/fern/products/docs/pages/getting-started/preview-changes-locally.mdx b/fern/products/docs/pages/getting-started/preview-changes-locally.mdx
index 0378ef8746..59e5094890 100644
--- a/fern/products/docs/pages/getting-started/preview-changes-locally.mdx
+++ b/fern/products/docs/pages/getting-started/preview-changes-locally.mdx
@@ -62,7 +62,16 @@ fern docs preview delete 
+
+
+If you set up your site using the [guided UI](https://dashboard.buildwithfern.com/get-started) or [CLI quickstart](/learn/docs/getting-started/quickstart), this workflow is automatically included in your repository. Otherwise, add it manually using the examples below.
These workflows require a `FERN_TOKEN` [repository secret](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions#creating-secrets-for-a-repository). If you used the guided workflow, this secret is added automatically. Otherwise, run [`fern token`](/learn/cli-api-reference/cli-reference/commands#fern-token) in your terminal to generate a token, then add it in your repository's **Settings > Secrets and variables > Actions** with the name `FERN_TOKEN`.