diff --git a/docs/reference/metadata/citation.qmd b/docs/reference/metadata/citation.qmd
index 658225146c..acc66614aa 100644
--- a/docs/reference/metadata/citation.qmd
+++ b/docs/reference/metadata/citation.qmd
@@ -16,3 +16,13 @@ citation:
   doi: 10.1145/3514174
 ---
 ```
+
+To customize the identifier of the citation:
+
+``` yaml
+---
+citation:
+  type: article-journal
+  id: lastname2022
+---
+```