diff --git a/packages/create-app/templates/default-app/app-config.yaml.hbs b/packages/create-app/templates/default-app/app-config.yaml.hbs
index c5aa5fafdb..ca52ec530c 100644
--- a/packages/create-app/templates/default-app/app-config.yaml.hbs
+++ b/packages/create-app/templates/default-app/app-config.yaml.hbs
@@ -107,5 +107,7 @@ catalog:
 kubernetes:
   # see https://backstage.io/docs/features/kubernetes/configuration for kubernetes configuration options
 
+# see https://backstage.io/docs/permissions/getting-started for more on the permission framework
 permission:
+  # setting this to `false` will disable permissions
   enabled: true