diff --git a/apps/strapi.frameless.io/docs/plugins/plugin-old-slugs.md b/apps/strapi.frameless.io/docs/plugins/plugin-old-slugs.md
new file mode 100644
index 000000000..95c670127
--- /dev/null
+++ b/apps/strapi.frameless.io/docs/plugins/plugin-old-slugs.md
@@ -0,0 +1,51 @@
+# Slug & Old Slugs
+
+## Wat is een slug?
+
+Een slug is het deel van een URL dat een pagina identificeert. Bijvoorbeeld:
+
+```
+https://www.digitalloket.nl/producten/test
+                                     ^^^^^
+                                     dit is de slug
+```
+
+---
+
+## Hoe werkt de slug in Strapi v5?
+
+Strapi v5 heeft een ingebouwde slug functie. De slug wordt **niet automatisch aangemaakt** — je maakt hem handmatig aan door op de **ronde pijl** naast het slug-veld te klikken. Strapi genereert dan een slug op basis van de titel.
+
+### Slug aanmaken of bijwerken
+
+1. Open een contentitem, bijvoorbeeld een product
+2. Vul de **title** in
+3. Klik op de **ronde pijl** naast het **slug** veld
+4. Strapi vult automatisch een slug in op basis van de titel
+5. Klik op **Bewaar** om de slug op te slaan
+
+---
+
+## Wat zijn Old Slugs?
+
+Wanneer je een slug aanpast, wordt de oude slug opgeslagen in het veld **oldSlugs**. Dit zorgt ervoor dat bezoekers die nog een oude URL gebruiken automatisch worden doorgestuurd naar de nieuwe pagina.
+
+### Voorbeeld
+
+- Oude slug: `/producten/test-oud`
+- Nieuwe slug: `/producten/test`
+
+Bezoekers die nog `/producten/test-oud` gebruiken — bijvoorbeeld via een opgeslagen bladwijzer of een oude link op een andere website — worden automatisch doorgestuurd naar `/producten/test`.
+
+### Waar zie je de old slugs?
+
+De oude slugs zijn zichtbaar in het veld **oldSlugs** onderaan het contentitem. Dit veld wordt automatisch bijgehouden door Strapi.
+
+---
+
+## Aandachtspunten
+
+- Klik altijd op de **ronde pijl** na het aanpassen van een titel om de slug bij te werken
+- Vergeet niet op **Bewaar** te klikken na het genereren van een nieuwe slug
+- Oude slugs blijven werken als redirect — je hoeft ze niet handmatig bij te houden
+- Heb je een slug gebruikt in een interne link ergens anders in Strapi? Pas die link dan ook handmatig aan