> ## Documentation Index
> Fetch the complete documentation index at: https://docs.listenlabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fix Study Issues

> Review the automatic checks on your study guide, then fix or dismiss each issue.

Study checks read your study guide and list possible problems. Fix an issue with the AI, or dismiss it if it does not apply to your study.

## Find the issues button

1. Open your study in the editor.
2. Find the issues button in the header, after the comments button. Its tooltip reads **Issues with study**.
3. Click the button to open **Setup suggestions**.

## When checks run

* A check starts about 10 seconds after a study version saves.
* Some recruitment changes also start a check.
* Opening the editor starts a check if the latest check covers an older version.
* The status under **Setup suggestions** shows **Updating...**, **Outdated**, or **Up to date**.
* When the status is **Outdated**, click the refresh icon to run a check now.

## Severity

* **Warning**: The study may not work, or the data may be wrong. Warnings are rare.
* **Recommendation**: A change that improves data quality. Most issues are recommendations.

Warnings appear first in the list. Examples:

* A concept is never shown to participants (warning).
* A closing message asks a question (recommendation).
* A question asks for an email address while incentives are on (recommendation).

If your workspace has study guidelines, checks also flag studies that do not follow them. See [Workspace Guidelines](https://docs.listenlabs.com/settings-and-management/workspace-guidelines.md).

## Fix or dismiss an issue

1. Click **Show details** to read the full explanation.
2. Click **Fix with AI** to send the issue to the chat. The chat opens.
3. To dismiss an issue, click the X icon on its card.

* If the chat fixes the issue, the issue leaves the list. If the chat cannot fix it, the issue stays.
* Dismissed issues move under **Show dismissed issues**. Click **Restore** to bring one back.
* Later checks try not to raise a dismissed issue again.

> [!NOTE]
>
> **Fix with AI** is off while the chat is writing. On an older version of the study, question issues are hidden and **Fix with AI** is off.

## Issues on a question

Questions with issues show a button with the issue count. Click it to see the issues for that question.

If the popover shows one issue, the X icon closes the popover without dismissing the issue. Click **Dismiss** to dismiss it.

## Who can use issues

* You need edit access to see the issues button. Viewers do not see it.
* You need edit access to dismiss, restore, or re-run issues.
* Issues do not block launch. They only warn.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.