From 6ffc9f4364f30739a5b1342c17d375cf90e4a9c9 Mon Sep 17 00:00:00 2001
From: Tim Vink <vinktim@gmail.com>
Date: Tue, 5 Sep 2023 08:44:14 +0200
Subject: [PATCH] Added documentation on slug feature for blog pages (#5966)

---
 docs/setup/setting-up-a-blog.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

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 } ·