diff --git a/docs/content/content/front-matter.md b/docs/content/content/front-matter.md
index 31bf52b5a..2a9d34a87 100644
--- a/docs/content/content/front-matter.md
+++ b/docs/content/content/front-matter.md
@@ -88,7 +88,10 @@ Field names are always normalized to lowercase (e.g. `camelCase: true` is availa
 
 ### Optional variables
 
-* **redirect** Mark the post as a redirect post
+* **aliases** An array of one or more aliases
+              (e.g. old published path of a renamed content)
+              that would be created to redirect to this content.
+              See [Aliases]({{< relref "extras/aliases.md" >}}) for details.
 * **draft** If true, the content will not be rendered unless `hugo` is called with `--buildDrafts`
 * **publishdate** If in the future, content will not be rendered unless `hugo` is called with `--buildFuture`
 * **type** The type of the content (will be derived from the directory automatically if unset)