diff --git a/doc/ci/testing/code_quality.md b/doc/ci/testing/code_quality.md
index 1d857b8f543fad22de7d1144de664313742a3705..ef9f0b86521c52e4a58cf869c5952f760c2d072f 100644
--- a/doc/ci/testing/code_quality.md
+++ b/doc/ci/testing/code_quality.md
@@ -710,3 +710,39 @@ Replace `gitlab.example.com` with the actual domain of the registry.
          mount_path = "/etc/docker/certs.d/gitlab.example.com/ca.crt"
          sub_path = "gitlab.example.com.crt"
    ```
+
+### Failed to load Code Quality report
+
+The Code Quality report can fail to load when there are issues parsing data from the artifact file.
+To gain insight into the errors, you can execute a GraphQL query using the following steps:
+
+1. Go to the pipeline details page.
+1. Append `.json` to the URL.
+1. Copy the `iid` of the pipeline.
+1. Go to [GraphiQL explorer](../../api/graphql/index.md#graphiql).
+1. Run the following query:
+
+   ```graphql
+   {
+     project(fullPath: "<fullpath-to-your-project>") {
+       pipeline(iid: "<iid>") {
+         codeQualityReports {
+           count
+           nodes {
+             line
+             description
+             path
+             fingerprint
+             severity
+           }
+           pageInfo {
+             hasNextPage
+             hasPreviousPage
+             startCursor
+             endCursor
+           }
+         }
+       }
+     }
+   }
+   ```