diff --git a/README.md b/README.md
index 7914204..ec7e6a8 100644
--- a/README.md
+++ b/README.md
@@ -32,6 +32,9 @@ dwf = []
 # the release or a changelog entry (optional)
 url = false
 
+# Single-line description of a vulnerability
+title = "Flaw in X allows Y"
+
 # Enter a short-form description of the vulnerability here (required)
 description = """
 Affected versions of this crate did not properly X.