diff --git a/fern/snippets/redirects.mdx b/fern/snippets/redirects.mdx
index de186cc0d..f41e74917 100644
--- a/fern/snippets/redirects.mdx
+++ b/fern/snippets/redirects.mdx
@@ -30,15 +30,15 @@ If your docs are hosted on a subpath (like `buildwithfern.com/learn`), include t
 </Info>
 
 <ParamField path="source" type="string" required={true}>
-  The incoming request path pattern.
+  The path you want to redirect from.
 </ParamField>
 
 <ParamField path="destination" type="string" required={true}>
   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`.
 </ParamField>
 
-<ParamField path="permanent" type="boolean" required={false}>
-  `true` or `false` - default is `true`. If `true`, will use the 308 status code which instructs clients/search engines to cache the redirect forever. If `false`, will use the 307 status code which is temporary and is not cached.
+<ParamField path="permanent" type="boolean" required={false} default="true">
+  By default, uses the 308 status code to instructs clients and search engines to cache the redirect forever. Set to `false` only if you need a temporary redirect using the 307 status code, which won't be cached.
 </ParamField>
 
 ### Best practices