# Setting up QA Credentials

Metaforms' AI-powered QA module automates survey link testing. It reads a questionnaire, generates a structured test plan, and executes test cases against the live survey link using browser automation — replacing the manual click-through process that QA testers do today.

{% hint style="warning" %}
It is recommended to create **one** dedicated Decipher account for QA testing for each Decipher Instance. These credentials are used exclusively for QA runs and are never shared externally.
{% endhint %}

### Prerequisites

Before setting up QA credentials, you’ll first need to connect your Decipher account to Metaforms. Refer to this guide to setup the connection: [connect-metaforms-to-decipher](https://help.metaforms.ai/setup/connect-metaforms-to-decipher "mention")

### How to Set Up QA Credentials for Decipher Surveys

Setting up a dedicated QA credential and the right project permissions helps Metaforms' QA agent to fully test all aspects of your Decipher surveys, including accessing all hidden variables in a Decipher survey.

Follow these steps to set up credentials and assign the proper permissions for seamless QA testing.

**Step 1:** Go to your **Decipher** dashboard and navigate to the **Company** page.

![](https://content.gitbook.com/content/gtHd8o9ldznZ1hKHiZvc/blobs/cp4VZiI8R057QO6IXH4n/c6eed08b%201dc4%204492%20a9c7%2058a08e2a7a69.png)

**Step 2:** Under **Users**, click to create a new user.

![](https://content.gitbook.com/content/gtHd8o9ldznZ1hKHiZvc/blobs/EkSIHH4lx2cC3yvu3I55/9070b7bb%2072ae%2041c6%20ae36%20dcb74cd05dfe.png)

**Step 3:** Enter the user's email address and leave other fields untouched.

![](https://content.gitbook.com/content/gtHd8o9ldznZ1hKHiZvc/blobs/mU6EEiOa4ndCsWl1uoFc/03df7a84%20a7a9%20453d%20b898%20a7f7c2744b96.png)

**Step 4:** Click **Create User**. This user doesn't need special access at this point.

![](https://content.gitbook.com/content/gtHd8o9ldznZ1hKHiZvc/blobs/truW1zVA5hj7JdNa2KtA/8561206c%20a43f%204ff4%2097db%203c9aaf7a2a51.png)

{% hint style="info" %}
The next steps can only be done by a user with Administrator access on Metaforms
{% endhint %}

**Step 5:** Go back to the Manager's Dashboard

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FgHvqumzjNA4OrV5amd2s%2FScreenshot%202026-03-20%20at%2010.27.24%E2%80%AFAM.png?alt=media&#x26;token=cdb1ec74-074b-45da-a29b-934f8fbef004" alt=""><figcaption></figcaption></figure>

**Step 6:** Under **Integrations,** select your Decipher instance and navigate to **QA Credentials.**

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FWATEHEMavhvJyW2sbuq7%2FScreenshot%202026-03-12%20at%205.48.15%E2%80%AFAM.png?alt=media&#x26;token=f2202bb7-45c2-4afb-b810-74a6a278c2bc" alt=""><figcaption></figcaption></figure>

**Step 7: E**nter the credentials for the user you created on Decipher, then click Save.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FyhgUmDNsT9OHHjO8SC9V%2FScreenshot%202026-03-12%20at%205.50.50%E2%80%AFAM.png?alt=media&#x26;token=60571375-8fdb-41e2-91d4-796474f523f5" alt=""><figcaption></figcaption></figure>

**Step 8:** You should see a confirmation message that your credentials have been saved.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FxfOrRKwa5fU5j77rRhA5%2Fimage.png?alt=media&#x26;token=dd8f42e4-5f79-4abd-b8f4-1d966ea1568f" alt=""><figcaption></figcaption></figure>

### Assign QA Access to a Project

Every time you create a new Decipher project or sync a project from Metaforms, grant the QA account access at the project level.

**Step 1:** In your Decipher dashboard, select the project you want the QA agent to test.

![](https://content.gitbook.com/content/gtHd8o9ldznZ1hKHiZvc/blobs/LdK273hMvFyHHPsZZTp6/26c2e6bd%200d00%204626%20a326%208bd78cd46a89.png)

**Step 2:** Click Users, then select Add User or Group.

![](https://content.gitbook.com/content/gtHd8o9ldznZ1hKHiZvc/blobs/A7mgCqkU8vA7nWmB5rUJ/93604c06%20c84c%2044db%208fe0%2061fa4ab8115c.png)

**Step 3:** Search for the QA account you created earlier.

![](https://content.gitbook.com/content/gtHd8o9ldznZ1hKHiZvc/blobs/19tFwtPOXfn0S6DNWqNR/9701bb39%20f47e%204e4c%20bd89%2001eaab30a21e.png)

**Step 4:** Assign **View Only** permission to this account.

**Step 5:** Click **Add Users**.

![](https://content.gitbook.com/content/gtHd8o9ldznZ1hKHiZvc/blobs/813AnaYGzGOfWxGfukmJ/6ee570ee%20f01f%20467b%2085f3%2024117101f5df.png)

### Testing the Survey With QA Credentials

After assigning project-level permissions,

**Step 1:** Go to the specific project on Metaforms and select **Link Testing**.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fh6FjdsH7nokbz4W3yBSV%2FScreenshot%202026-03-10%20at%202.18.36%E2%80%AFAM.png?alt=media&#x26;token=942b866c-8eb2-4910-8d38-a47c03c1c8c6" alt=""><figcaption></figcaption></figure>

**Step 2:** Click on **Start** to generate the test plan.

![](https://content.gitbook.com/content/gtHd8o9ldznZ1hKHiZvc/blobs/KdOPddKoaAN3kmAfML8f/00691a17%201d11%2049e0%20acf5%203f812ae6449e.png)

**Step 3:** In the dialog box, enter the survey link provided by Decipher.

![](https://content.gitbook.com/content/gtHd8o9ldznZ1hKHiZvc/blobs/UXbwqRgoGT0pYQCHx0Cz/5fcd8ceb%2036e8%204bf8%208356%20e9538558f3e7.png)

**Step 4:** Confirm the correct QA-configured Decipher account is active (it should be marked as QA configured).

![](https://content.gitbook.com/content/gtHd8o9ldznZ1hKHiZvc/blobs/rgtVy9VANIQPSbY6ecIG/20e5cb4d%2092d0%204d12%20b0ca%20d6accbe100f9.png)

**Step 5:** Before testing, make sure to disable all quotas and turn off bot detection or CAPTCHA in your survey's settings.

**Step 6:** Confirm you have given the QA account view access to the project.

![](https://content.gitbook.com/content/gtHd8o9ldznZ1hKHiZvc/blobs/2l9EsE2m0mEZIIdR5gkx/5cd8c6bb%20d10e%20469b%209ea8%208a47b600c9c2.png)

**Step 7:** Click **Generate Test Plan** to start the QA process.

![](https://content.gitbook.com/content/gtHd8o9ldznZ1hKHiZvc/blobs/B767bJT6gGkEWnTxyOJ5/18f99e7d%20438f%204c26%209df3%20f4a933d9dd39.png)