diff --git a/changelog/changelog-template.yaml b/changelog/changelog-template.yaml
index b3e47fe7827c..77bf1fcd9005 100644
--- a/changelog/changelog-template.yaml
+++ b/changelog/changelog-template.yaml
@@ -1,2 +1,3 @@
-message:
-type:
+message: # "Description of your change" (required)
+type: # One of "feature", "bugfix", "dependency", "deprecation", "breaking_change", "performance" (required)
+scope: # One of "Core", "Plugin", "PDK", "Admin API", "Performance", "Configuration", "Clustering", "Portal", "CLI Command" (optional)