# Clarification Sheet

The **Clarification Sheet** allows you to document logic, assumptions, and special instructions for each question in your questionnaire - particularly useful when dealing with complex logic or ambiguous inputs.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FUDFYqmwTerN6xItN4Gvb%2FScreenshot%202025-06-20%20at%202.30.23%E2%80%AFPM.png?alt=media&#x26;token=a5ae6e67-eb02-4708-a7a2-d1269fb2b6f9" alt=""><figcaption></figcaption></figure>

Each entry in the Clarification Sheet is tied to a specific **QID** (question ID) from your questionnaire and includes the following fields by default:

* **Reference (QID)**
* **Query**
* **Query Type**
* **Feedback**
* **Status**

This structured format ensures your clarifications are well-organized and traceable throughout the survey build process.&#x20;

{% hint style="info" %}
You can however also choose to have your own format for the clarification sheet.
{% endhint %}

## **Types of Clarifications**

There are broadly four key clarification categories:

1. **Instructions**\
   Specific guidance or opinions on how a question should be programmed - especially useful for complex logic or unconventional flows.
2. **Decisions**\
   Any programming decisions made by the survey programmer that deviate from the questionnaire content - to maintain transparency.
3. **Clarifications**\
   Questions sent to clients for additional input, along with their responses - recorded to maintain a clear history of communication.
4. **Assumptions**\
   Logical assumptions made by the programmer in case of ambiguity in the questionnaire - helps document intent behind code.

## **AI Clarification Suggestions (Beta)**

Metaforms includes an AI-powered suggestions tool (in Beta), which analyzes your questionnaire and offers:

* Suggested clarifications for complex questions
* Detection of logical inconsistencies
* Highlighting of typos and potential improvements

You can easily review, accept, or discard these AI suggestions as needed.

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2FD7pQS1OVUGj7PKc1Ymj0%2FScreenshot%202025-06-20%20at%202.31.33%E2%80%AFPM.png?alt=media&#x26;token=66f730f6-11e4-44d5-8e03-3474d7b9d59f" alt=""><figcaption></figcaption></figure>

**To Enable AI Clarification Suggestions:**

* Navigate to **Settings -> Features -> Enable Clarification Sheet Suggestions** and **save changes.**

<figure><img src="https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fu7DZmCKiFPpzFVe8cPbZ%2FScreenshot%202025-06-20%20at%202.33.11%E2%80%AFPM.png?alt=media&#x26;token=dc6f3c26-e1ec-4158-b4b5-d31e5d9d53d5" alt=""><figcaption></figcaption></figure>

## **Additional Features**

* You can **create multiple Clarification Sheets** within a project.
* Sheets can be **imported or exported** in bulk for documentation or reuse.
* Clarifications directly improve the **quality and precision** of XML generation using AI.