From 8b9695fa6c833c4bf8172db6d3dc8269d9ff9d47 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 5 May 2026 12:59:51 +0000
Subject: [PATCH] docs: add FAQ entry for GitHub login verified email
 requirement

---
 faq/faq.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/faq/faq.md b/faq/faq.md
index 1359294..1d61e05 100644
--- a/faq/faq.md
+++ b/faq/faq.md
@@ -82,6 +82,12 @@ kosli report evidence artifact generic server:1.0 \
 `--compliant` is set to `true` by default, so to report as compliant simply skip the flag altogether.
 </Accordion>
 
+<Accordion title="Why is my GitHub login failing?">
+If you sign in to Kosli with GitHub, you must have a verified email address on your GitHub account — otherwise login will fail.
+
+You can check the status of your email addresses at [github.com/settings/emails](https://github.com/settings/emails).
+</Accordion>
+
 <Accordion title="Why can't I delete or archive a policy?">
 It's not possible to delete a policy in Kosli. This is by design, because there can be snapshots that were previously evaluated using the policy. Deleting it would compromise the integrity of those historical evaluations.