# Run QA Tests

This step-by-step guide shows you how to generate automated test plans, review detected issues, and export actionable reports.

**Step 1:** Go to the **Link Testing** tab

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FOrfWHDF4L6AoSrqtRkpI%2Fimage.png?alt=media&#x26;token=8f086b22-3417-4c02-912b-1b794e7af22c" alt=""><figcaption></figcaption></figure>

**Step 2:** Once your survey is programmed, open the **Link Testing** tab and click on **Start**.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FWJ1qbi2Ia4m56GYGXR2P%2Fimage.png?alt=media&#x26;token=75295753-15cb-4b6c-b07a-811eb96fa6d6" alt=""><figcaption></figcaption></figure>

**Step 3:** Enter your survey link and select the **Decipher** instance configured for QA.

Make sure to perform these actions in Decipher for that specific project and then check the boxes in the dialog.

* Disable all quotas
* Disable bot detection
* Add the QA-specific user in Decipher for this project with Viewer Access

{% hint style="info" %}
Doing this will allow the QA Agent access the Decipher Recorder Tool and hidden variables
{% endhint %}

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fv6Drvo0gLfZArDq5SYA8%2Fimage.png?alt=media&#x26;token=552cd88c-a3ff-4144-8292-e5c69d10c73e" alt=""><figcaption></figcaption></figure>

**Step 4:** Click **Generate Test Plan**.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FhzD1lMmlwetpp9WHAh4D%2Fimage.png?alt=media&#x26;token=98873ef5-7e20-4715-9e2a-130d0ef1a86e" alt=""><figcaption></figcaption></figure>

**Step 5:** You’ll see the agent interface on the right as it begins creating your test cases.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FYSkRnt3Fihz0NxeE7OWf%2Fimage.png?alt=media&#x26;token=81035cc1-e860-4fdb-ab99-fcd9f00bcfb7" alt=""><figcaption></figcaption></figure>

**Step 6:** You can review your survey sections on the left. Click any question to see the checks generated for it. Checks include presence, logical, and textual validations for each question.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FblggGEl551XWCOl1SyrG%2Fimage.png?alt=media&#x26;token=63e53aec-2b07-4001-b95d-8ca929adf652" alt=""><figcaption></figcaption></figure>

**Step 7:** Need a new test? Type your request in the agent’s chat. The agent confirms when the new test is added.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FQVjo0pmMiSIjZeIfIOpH%2Fimage.png?alt=media&#x26;token=8e156188-dd9f-4d59-aeaa-a9f05cae756c" alt=""><figcaption></figcaption></figure>

**Step 8:** Once generated, your tests will run automatically. You’ll get a notification by email when execution finishes.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fn0OOAn0GkCxh1XqSDv1g%2Fimage.png?alt=media&#x26;token=53eba42d-62e7-43ba-b1f6-21d47151998c" alt=""><figcaption></figcaption></figure>

**Step 9:** On completion, you’ll find a **Needs Attention** section that highlights issues detected by the agent.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FAmCnfr2ZbMjJFC47vGdB%2Fimage.png?alt=media&#x26;token=a1a8d92d-f3ea-4105-acc2-74ffd4beeeb5" alt=""><figcaption></figcaption></figure>

**Step 10:** See the specific question names and the agent’s identified issues with detailed messages.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FM1HC240t0wneS5q6gBvQ%2Fimage.png?alt=media&#x26;token=2dcfd7b8-124e-42b7-9938-7d8500a4a9c6" alt=""><figcaption></figcaption></figure>

**Step 11:** You can also click on a question to review all the checks performed by the agent.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FP3UYYI0c0l8hnVU12W7c%2Fimage.png?alt=media&#x26;token=798cae8c-afa8-478e-9339-d33aa9858600" alt=""><figcaption></figcaption></figure>

For each issue, check the agent’s explanations, which include feedback on formatting, display logic, and more.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FdXBb0yz3XM4rcW02wQ3v%2Fimage.png?alt=media&#x26;token=d5c96f8c-ff70-49d1-950d-7f94abf0c9a8" alt=""><figcaption></figcaption></figure>

**Step 12:** Once reviews are done, click **Export Report**. For a focused summary, choose **Export Failures Only**.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2F8FMIvX78KCIQzfL7EJk3%2Fimage.png?alt=media&#x26;token=7af502d2-4001-4022-9853-5eca6fc13501" alt=""><figcaption></figcaption></figure>

## Retesting Links After Making Changes

After updating your survey, it’s important to re-run your link tests to ensure everything works as expected. The link testing panel gives you flexible options to manage your test runs.

**Step 1:** Open the **link testing panel** and start a **new test run** to check your updated survey.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FRee1xiUHUxnwiGRjj7zo%2FScreenshot%202026-03-10%20at%203.01.44%E2%80%AFAM.png?alt=media&#x26;token=5f6a0ff0-5a49-4452-a436-11e3affdd2e0" alt=""><figcaption></figcaption></figure>

**Step 2:** If the survey structure hasn't changed, click **Reuse test plan from test one** to save time. If there are major changes, let the AI generate a **new test plan**.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FNhJmSUnW4saGzKCeo6Pp%2Fimage.png?alt=media&#x26;token=4237b693-9054-4290-bae7-c62d3d21674a" alt=""><figcaption></figcaption></figure>

The rest of the testing workflow remains unchanged.
