From bf1fd4d74cd5667cb8ce22911edd281fec7b3377 Mon Sep 17 00:00:00 2001
From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com>
Date: Mon, 21 Sep 2026 20:04:14 +0000
Subject: [PATCH] docs(redirects): document mailto: and tel: as valid redirect
schemes
---
fern/products/docs/pages/seo/redirects.mdx | 2 ++
fern/products/docs/snippets/redirects.mdx | 2 +-
2 files changed, 3 insertions(+), 1 deletion(-)
diff --git a/fern/products/docs/pages/seo/redirects.mdx b/fern/products/docs/pages/seo/redirects.mdx
index 28d12a52f9..7c31bd291b 100644
--- a/fern/products/docs/pages/seo/redirects.mdx
+++ b/fern/products/docs/pages/seo/redirects.mdx
@@ -21,6 +21,8 @@ If your docs are hosted on a subpath (like `buildwithfern.com/learn`), include t
destination: "/new-folder/path"
- source: "/old-folder/path"
destination: "https://www.example.com/fern" # External destination
+ - source: "/contact-support"
+ destination: "mailto:support@example.com" # mailto: and tel: destinations are passed through verbatim
- source: "/temporary-redirect"
destination: "/new-location"
permanent: false # Use 307 (temporary) instead of 308 (permanent)
diff --git a/fern/products/docs/snippets/redirects.mdx b/fern/products/docs/snippets/redirects.mdx
index 9727c22949..aebe7aa90e 100644
--- a/fern/products/docs/snippets/redirects.mdx
+++ b/fern/products/docs/snippets/redirects.mdx
@@ -3,7 +3,7 @@
- The path you want to route to. Can be an internal path (`/new-path`) or an external URL (`https://example.com`). External URLs must include the full address, including `https`.
+ The path you want to route to. Can be an internal path (`/new-path`) or an external URL (`https://example.com`). External URLs must include the full address, including the scheme. Supported external schemes are `https://`, `http://`, `mailto:`, and `tel:`.