diff --git a/content/insights/installing-and-configuring-github-insights/installing-github-insights.md b/content/insights/installing-and-configuring-github-insights/installing-github-insights.md
index 18658d914df3..cfbb50379626 100644
--- a/content/insights/installing-and-configuring-github-insights/installing-github-insights.md
+++ b/content/insights/installing-and-configuring-github-insights/installing-github-insights.md
@@ -55,6 +55,7 @@ To connect {% data variables.product.prodname_insights %} to {% data variables.p
       - Metadata: **Read-only**
       - Pull requests: **Read-only**
       - Commit statuses: **Read-only**
+      - Issues: **Read-only**
     - Organization:
       - Members: **Read-only**
       - Projects: **Read-only**
diff --git a/content/insights/installing-and-configuring-github-insights/updating-github-insights.md b/content/insights/installing-and-configuring-github-insights/updating-github-insights.md
index e17b23f341d4..a9149453222d 100644
--- a/content/insights/installing-and-configuring-github-insights/updating-github-insights.md
+++ b/content/insights/installing-and-configuring-github-insights/updating-github-insights.md
@@ -15,6 +15,16 @@ Before you update {% data variables.product.prodname_insights %}, you can check
 
 The update process will take up to 10 minutes. During this time, users cannot access {% data variables.product.prodname_insights %}.
 
+### Updating from {% data variables.product.prodname_insights %} 1.5.0-alpha.1
+
+To update {% data variables.product.prodname_insights %} from 1.5.0-alpha.1, you must first add the `read:issues` permission to your {% data variables.product.prodname_github_app %}.
+To do this, the navigate to the {% data variables.product.prodname_github_app %} that you created when you [first installed {% data variables.product.prodname_insights %}](/github/installing-and-configuring-github-insights/installing-github-insights#creating-a-github-app).
+Edit the App Permissions to add:
+- Repository
+  - Issues: **Read-only**
+
+Then you may continue updating {% data variables.product.prodname_insights %} to the latest version by following [the steps below](/github/installing-and-configuring-github-insights/updating-github-insights#updating-from-github-insights-040).
+
 ### Updating from {% data variables.product.prodname_insights %} 0.4.0+
 
 To update {% data variables.product.prodname_insights %} from 0.4.0+, you can install the latest version. {% data variables.product.prodname_insights %} will ask to use the previous installation configuration.