# Quiz form section

The "Quiz" section in the MaviBot site builder is a functional tool that allows you to create interactive surveys and questionnaires directly on your site.

<figure><img src="/files/4ajnGi5R71L81r7CVF1e" alt="" width="563"><figcaption></figcaption></figure>

This tool simplifies the collection of user opinions and data, making client interactions more engaging and insightful. In this article, we will detail how to configure the "Quiz" section to maximize its benefits for your business and enhance the quality of audience feedback.

## How to create a quiz form

**To create a quiz, follow these steps:**

**a) Create a new website** – if you want to build the quiz on a standalone site.

**b) Add the "Quiz" section** – if you want to integrate it into an existing website.

Once in the editor, locate the **"Quiz"** button in the menu.

<figure><img src="/files/Gbh2T6Br9Niv0kKrHs5e" alt=""><figcaption></figcaption></figure>

Click on the "Quiz" section to add it to your site page.

#### Page-by-page survey

A page-by-page survey (or quiz) is a questionnaire format where questions are split across multiple pages. Users answer sequentially, proceeding from one page to the next. This approach makes the interaction more convenient by presenting questions individually or in small groups, rather than as a single long list.

<figure><img src="/files/ILdCB1SJDNYSmEvfEDap" alt="" width="375"><figcaption></figcaption></figure>

**Page-by-page survey advantages**

* **Better focus:** users are not overwhelmed by a long list of questions and can concentrate on each one individually.
* **Higher engagement:** the step-by-step format is more interactive and helps maintain user interest.
* **Accurate data collection:** the structured flow allows for more precise questions and enables adaptive questioning based on previous answers.

Such surveys are ideal for gathering feedback, conducting market research, and generating leads.

**Getting started**

After creating a site or adding a quiz section, you will see the configuration menu for this block:

<figure><img src="/files/YXjBiLRq20eUYeeqpONX" alt=""><figcaption></figcaption></figure>

Next, in the "number of pages" field, specify the required number of pages where your questions will be located, not counting the start page and the results page:

<figure><img src="/files/8AxRc5c0mvh9WHLWhzjo" alt=""><figcaption></figcaption></figure>

First you need to click on "Create a question"

<div><figure><img src="/files/RYc3zTYs1qmlQU6DoNjy" alt="" width="563"><figcaption><p>Сначала необходимо кликнуть на "Создать вопрос"</p></figcaption></figure> <figure><img src="/files/kZgbvx7ovwZc2JXP4SaW" alt="" width="375"><figcaption><p>Первый вопрос - на первой странице</p></figcaption></figure></div>

The first question is on the first page

In the settings menu content, after creating a question, you will find the following drop-down list:

<figure><img src="/files/7SVyPqnxuHu9twgKnb7h" alt="" width="563"><figcaption></figcaption></figure>

Each page of the quiz (page-by-page survey) contains its own content, which is configured separately from each other.

For example, on the home page you can place images, on the survey pages you can place the questions themselves, as well as the data collection forms, and in the results - the final result of the survey.

### Survey Pages

After creating the first question, go to fill it out:

Step 1. Write down the question itself:

<figure><img src="/files/lUoYL5Jcj3lfjYmyFWvs" alt="" width="563"><figcaption></figcaption></figure>

Next, select the question type:

<div><figure><img src="/files/tiMD5jo6KC0hP4EuQbMo" alt=""><figcaption></figcaption></figure> <figure><img src="/files/GLQerj8B8gUlOMryAWh8" alt=""><figcaption></figcaption></figure></div>

For example, you can select the "Numeric Field" type, then your client can enter only a numeric value during the survey.

You can choose other types of questions, depending on what results you need to get and how to account for them.

{% hint style="info" %}
For more information about the types of fields, see the main article "Form Responses" in the section "Content settings: subsection [Create a question](#creating-a-quiz-form).&#x20;
{% endhint %}

If you choose the types of questions in the form of "Name", "Email", "Phone", etc., then you do not need to enter the text of the question and the answer to it in the content settings - everything is set in advance by the developers.:

Step 2. Add answers if you have selected the types of questions in which the client needs to choose an answer option:

<figure><img src="/files/XJHvEyF5HXJ0il1bCfFC" alt="" width="563"><figcaption></figcaption></figure>

You can enter a link to the image in the URL field: then the image will appear in the field with the question:

<figure><img src="/files/AngVT2uwzdG7DmhqPtlo" alt="" width="563"><figcaption></figcaption></figure>

To do this, upload the required image to the file storage:

<figure><img src="/files/Bb9LafbSV1fFLiRDPXdH" alt="" width="265"><figcaption></figcaption></figure>

And after the image is uploaded, copy the link to it:

<figure><img src="/files/NHsygHurKZhYnFOBmXR6" alt=""><figcaption></figcaption></figure>

Paste the link into the URL field, and the image will appear in the required question bar:

<figure><img src="/files/l3x2VJetFWZ8edbRiMne" alt=""><figcaption></figcaption></figure>

Next, if you fill in the "Free answer" field, your user can enter the answer to his question in free form:

<figure><img src="/files/kQbqIGomkh0k1YvKItNO" alt="" width="563"><figcaption></figcaption></figure>

In this field, enter a text value, for example, "Free answer" or "Your answer":

<figure><img src="/files/7NoEse5LYY3k3ZIpKirF" alt="" width="563"><figcaption></figcaption></figure>

Then the client can enter the answer to the question in free form:

<figure><img src="/files/ZAnarkZz4Wf4KTg7YNMV" alt=""><figcaption></figcaption></figure>

Step 3. The variable

You can set your own variable to collect data into the system, or leave the set name for the variable:

<figure><img src="/files/Hlxa50nCgiosm8GKQTxJ" alt="" width="563"><figcaption></figcaption></figure>

The value that your client chooses will be inside the variable.

Step 4. Required question&#x20;

If you need the client to answer the question you have created, then use this checkbox:

<figure><img src="/files/4GaHXfrnDwcD4soTann5" alt="" width="375"><figcaption></figcaption></figure>

During activating the "Required Question" checkbox, the client cannot submit the form if he does not provide an answer to the required question.

This checkbox can be set on any type of question: both when choosing an answer option and when the client enters a phone number or email.

Step 5. Add the following questions to the page

To add any required number of questions on the current page, find the "Add Question" button under the previous question:

<figure><img src="/files/ZCWFHyOcwrp7sd2Af2IK" alt="" width="375"><figcaption></figcaption></figure>

Then you will see the next panel with the question settings:

<figure><img src="/files/mZSnHvGnF6pwXIIU1bU1" alt="" width="375"><figcaption></figcaption></figure>

The settings of the newly added questions are identical to steps 1-4.

Step 6. Configure the next page.

After you have fully configured page 1, depending on the number of installed pages in the setup, you need to proceed to configuring the second (and then the third, fourth, etc.) page. To do this, scroll up and find the drop-down list with the page settings option:

<figure><img src="/files/lQmXcXLaRWSDwqyUuwUN" alt="" width="563"><figcaption></figcaption></figure>

Select the page you want to set up and click on it:

<figure><img src="/files/wBUI9H2bHxoj6iN8EA0l" alt="" width="563"><figcaption></figcaption></figure>

Here you will see the "Add another question" button.

{% hint style="success" %}
The questions on the following pages are configured similarly to steps 1-5.
{% endhint %}

### Start page

The start page settings and the result page are optional, so if you do not want to customize the cover for your quiz, you can skip it, and then your client will immediately see the questions from the first page.

If, for example, you need to customize the cover of your website, then find the drop-down list with pages and click "Home Page":

<figure><img src="/files/INp6YYiF3cBwfWsQWBsN" alt="" width="563"><figcaption></figcaption></figure>

Select start page.

Step 1. Create a start page:

<figure><img src="/files/jDH85h3Q6usIBtIGhyUH" alt="" width="563"><figcaption></figcaption></figure>

You will see the settings for uploading the image, title and subtitle.

Step 2. Write the Title and Subtitle for the start page

The Header and Subtitle fields are optional, but, for example, you can specify a unique offer to attract customers:

<figure><img src="/files/bs5Qxu88wx5NSNgqezY9" alt="" width="563"><figcaption></figcaption></figure>

The settings for the text elements of quizzes are similar to any text editor: you can choose bold, italics, text underlining, font size, color, alignment, and more:

<figure><img src="/files/XRbsK1236sH3RFK81ODb" alt="" width="563"><figcaption></figcaption></figure>

Step 3. Upload the image.

Add an image to make the section and the home page more colorful:

<figure><img src="/files/kcb2ZgxTfvq1zXJJLUft" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
It's done!

You were able to set up the start page of the page-by-page survey.
{% endhint %}

## How to add messenger buttons to the quiz section?

First, we recommend switching to content editing:

<figure><img src="/files/FsjjE20ftg1xf7tDwm0G" alt=""><figcaption></figcaption></figure>

And add checkboxes to the consent form for data processing:

<figure><img src="/files/silsM7ZsWQCSo0Nf9xTf" alt=""><figcaption></figcaption></figure>

Hover over the section to find the "Settings" button.

<figure><img src="/files/hz7yncVcdy2gyNogOqYC" alt=""><figcaption></figcaption></figure>

Click on the button, then the settings menu opens on the right:

<figure><img src="/files/eMBcLjK9CvCxq83sJVqM" alt=""><figcaption></figcaption></figure>

Now expand the "Button Settings" drop-down menu:

<figure><img src="/files/4mrilaRG7ilw1EP42LW6" alt=""><figcaption></figcaption></figure>

And click on the "Messengers" button:

<figure><img src="/files/ud2ieEvpn2vzSI9QNJql" alt=""><figcaption></figcaption></figure>

You will see a list of messengers which buttons can be added to the quiz form. Set the checkboxes of the buttons that you want to display on the page:

<figure><img src="/files/b751t9oUwKDK6wb0DZjN" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
Pay attention!&#x20;

Only the messenger buttons that are connected in the "Channels" section will be displayed.
{% endhint %}

Next, you can customize the button at your discretion by clicking on "Customize" in the line:

<figure><img src="/files/vGHnV8AtroaqH161ZyVy" alt="" width="563"><figcaption></figcaption></figure>

For example, you can customize a button to match the color scheme of your site, add text, etc:


---

# Agent Instructions: 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://docs.mavibot.ai/websites/sites/blocks/quiz-form-section.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.
