> For the complete documentation index, see [llms.txt](https://help.metaforms.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.metaforms.ai/survey-programming-decipher/legacy-flow/build-page-walkthrough/clarification-sheet.md).

# 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="/files/o1Xt1qLRNM7XVYqS5wBV" 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.

{% 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="/files/jI7UfffskugRRGPdkAoT" alt=""><figcaption></figcaption></figure>

**To Enable AI Clarification Suggestions:**

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

<figure><img src="/files/6vVXqERLnTS2VGYHuHMm" 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.metaforms.ai/survey-programming-decipher/legacy-flow/build-page-walkthrough/clarification-sheet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.