diff --git a/docs/faq.md b/docs/faq.md
index 07d866aa..21d107ff 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -157,12 +157,40 @@ level group for Self-Hosted GitLab.
 
 #### Unable to Enable Repositories in GitLab
 
-If you’re having trouble enabling the GitLab Repositories toggle, confirm that
+If you're having trouble enabling the GitLab Repositories toggle, confirm that
 you have Maintainer access in the primary group for GitLab Cloud or in the first
 level group for Self-Hosted GitLab.
 
 ## Account Management {#account-management}
 
+### How to troubleshoot CodeRabbit not functioning on certain repositories?
+
+If CodeRabbit is not functioning on certain repositories, it is likely due to the repository not being accessible to CodeRabbit and you must reinstall the GitHub App or GitLab Integration.
+
+To troubleshoot this issue, please attempt to reinstall the GitHub App or GitLab Integration by following the steps below:
+
+<Tabs>
+  <TabItem value="general" label="General Instructions" default>
+    1. Confirm that the author of a pull request has an active seat in CodeRabbit. If not please provide a seat to the user under [Subscription](https://coderabbit.ai/settings/subscription) page to enable CodeRabbit for the user.  Then have the user close/reopen a new pull request for the change to see coderabbit active on the new user. ![Seat Assignment](/img/faq/seat-assignment.png)
+    3. Please insure if not selecting all repositories, that you have added all repositories that you would like to enable to the selected list in the app configuration.
+    4. If the repository is not in the list, you do not have to uninstall and reinstall the CodeRabbit App. Please add it to the list. ![Select Repos](/img/faq/select-repos.png)
+  </TabItem>
+
+  <TabItem value="github" label="GitHub">
+    1. Go to Repository settings
+    2. Click **GitHub Apps** in the left sidebar under **Integrations**
+    3. Select **Configure** ![Select Repos](/img/faq/github-app-settings.png)
+    4. Click **Uninstall** at the bottom of the app configuration page. ![Uninstall](/img/faq/coderabbit-github-menu.png)
+    5. Go into the [Coderabbit App](https://github.com/apps/coderabbitai) and install it again with the **Add Repository** button. ![Add Repository](/img/faq/add-repository.png)
+  </TabItem>
+
+  <TabItem value="gitlab" label="GitLab">
+    1. Remove OAuth App from User Settings > Applications
+    2. Remove Webhook from Group > Project Settings > Webhooks
+    3. Go into the [Coderabbit App](https://gitlab.com/apps/coderabbitai) and install it again. ![Install](/img/faq/gitlab-webhook.png)
+  </TabItem>
+</Tabs>
+
 ### How do I delete my CodeRabbit account?
 
 :::danger Irreversible Account Deletion
diff --git a/static/img/faq/add-repository.png b/static/img/faq/add-repository.png
new file mode 100644
index 00000000..e69c4a7c
Binary files /dev/null and b/static/img/faq/add-repository.png differ
diff --git a/static/img/faq/coderabbit-github-menu.png b/static/img/faq/coderabbit-github-menu.png
new file mode 100644
index 00000000..c599ca95
Binary files /dev/null and b/static/img/faq/coderabbit-github-menu.png differ
diff --git a/static/img/faq/github-app-settings.png b/static/img/faq/github-app-settings.png
new file mode 100644
index 00000000..ff120953
Binary files /dev/null and b/static/img/faq/github-app-settings.png differ
diff --git a/static/img/faq/gitlab-webhook.png b/static/img/faq/gitlab-webhook.png
new file mode 100644
index 00000000..a233f902
Binary files /dev/null and b/static/img/faq/gitlab-webhook.png differ
diff --git a/static/img/faq/seat-assignment.png b/static/img/faq/seat-assignment.png
new file mode 100644
index 00000000..073194be
Binary files /dev/null and b/static/img/faq/seat-assignment.png differ
diff --git a/static/img/faq/select-repos.png b/static/img/faq/select-repos.png
new file mode 100644
index 00000000..1c1222ff
Binary files /dev/null and b/static/img/faq/select-repos.png differ