diff --git a/doc/integration/jira/troubleshooting.md b/doc/integration/jira/troubleshooting.md
index 3f71a73f048098cb04c2ef0842660e387ba9ec95..6a735b4785c15fdcad6fa533a9ad5ee0bbfb95ad 100644
--- a/doc/integration/jira/troubleshooting.md
+++ b/doc/integration/jira/troubleshooting.md
@@ -14,6 +14,22 @@ title: Troubleshooting Jira issues integration
 
 When working with the [Jira issues integration](configure.md), you might encounter the following issues.
 
+## Verified Jira credentials failing
+
+If you verified your Jira credentials are correct, the integration may still fail to connect.
+This can happen when credentials become stuck in an incorrect state in the GitLab system.
+
+To resolve this issue, reset the credentials:
+
+1. On the left sidebar, select **Search or go to** and find your project.
+1. Select **Settings > Integrations**.
+1. Select **Jira issues**.
+1. At the bottom of the page, select **Reset**.
+1. Re-enter your credentials and select **Save changes**.
+
+This reset clears any cached or incorrectly stored credential data and forces GitLab to establish a
+fresh connection with your Jira instance.
+
 ## GitLab cannot link to a Jira issue
 
 When you mention a Jira issue ID in GitLab, the issue link might be missing.