diff --git a/docs/setup/setting-up-a-blog.md b/docs/setup/setting-up-a-blog.md
index d188614ff..5cb2526c9 100644
--- a/docs/setup/setting-up-a-blog.md
+++ b/docs/setup/setting-up-a-blog.md
@@ -1177,6 +1177,19 @@ linked with their titles.
   [built-in tags plugin]: setting-up-tags.md#built-in-tags-plugin
   [tags index]: setting-up-tags.md#adding-a-tags-index
 
+#### Changing the slug
+
+Slugs are the shortened description of your post used in the URL. They are automatically generated, but you can specify a custom slug for a page:
+
+``` yaml
+---
+slug: hello-world
+---
+
+# Hello there world!
+...
+```
+
 #### Adding related links
 
 [:octicons-heart-fill-24:{ .mdx-heart } Sponsors only][Insiders]{ .mdx-insiders } ·