diff --git a/releasenotes/notes/file-comment-levels-9b26156addc3644f.yaml b/releasenotes/notes/file-comment-levels-9b26156addc3644f.yaml
index ec5dff2bbc..8fef22c770 100644
--- a/releasenotes/notes/file-comment-levels-9b26156addc3644f.yaml
+++ b/releasenotes/notes/file-comment-levels-9b26156addc3644f.yaml
@@ -8,3 +8,6 @@ features:
 
     For more details on how to provide file comments from Zuul, see the
     documentation of the :ref:`return_values`.
+
+upgrade:
+  - With GitHub the Zuul app now requires permissions to read/write check runs.