diff --git a/.forestry/front_matter/templates/blog-post.yml b/.forestry/front_matter/templates/blog-post.yml
index 5c38d264..e4d13597 100644
--- a/.forestry/front_matter/templates/blog-post.yml
+++ b/.forestry/front_matter/templates/blog-post.yml
@@ -17,7 +17,10 @@ fields:
   label: date
 - type: text
   name: permalink
-  label: permalink
+  label: Permalink
+  description: The permanent URL for this post. Must start and end with slashes. For
+    blog posts, include the date (<em>/2022-09-23-descriptive-title/</em>); for weekly
+    newsletters, use the edition number(<em>/weekly-123/</em>).
 - type: text
   name: translationKey
   label: translationKey