> For the complete documentation index, see [llms.txt](https://docs.mluvii.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mluvii.com/en/for-administrators/tenant-management/settings/forms/forms.md).

# Forms

{% hint style="info" %}
*In this section, you will find instructions on how to edit an **entry**, **feedback**, **offline**, and **call script** to best serve your company's needs. Find out how to add forms to the WebChat widget* [*below*](#jpf)*.*
{% endhint %}

The Forms editor can be accessed via ***Settings -> Forms***. Form settings can be made by users with minimum **Tenant admin** permission.

{% hint style="success" %}
*Click on the Copy icon to edit the basic layout of the selected form. However, you can also build **your custom.***
{% endhint %}

## Default and custom forms

In the following table, you can see supported components across different form types - **entry**, **feedback**, **offline, and call-script**.

<table><thead><tr><th width="236">Component</th><th width="120" align="center">Entry</th><th align="center">Feedback</th><th align="center">Offline</th><th align="center">Call-script</th></tr></thead><tbody><tr><td><a href="#aaa"><strong>Text</strong></a></td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td></tr><tr><td><strong>Image</strong></td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td></tr><tr><td><strong>Video</strong></td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td></tr><tr><td><a href="#aab"><strong>Field</strong></a></td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td></tr><tr><td><a href="#aac"><strong>List</strong></a></td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td><td align="center">✔</td></tr><tr><td><strong>Authentication buttons</strong></td><td align="center">✔</td><td align="center">x</td><td align="center">x</td><td align="center">x</td></tr><tr><td><a href="#aad"><strong>GDPR</strong></a></td><td align="center">✔</td><td align="center">x</td><td align="center">x</td><td align="center">x</td></tr><tr><td><a href="#aae"><strong>Rating</strong></a></td><td align="center">x</td><td align="center">✔</td><td align="center">x</td><td align="center">x</td></tr><tr><td><a href="#feedback"><strong>Feedback</strong></a></td><td align="center">x</td><td align="center">✔</td><td align="center">x</td><td align="center">x</td></tr><tr><td><a href="#aaf"><strong>Transcript</strong></a></td><td align="center">x</td><td align="center">✔</td><td align="center">x</td><td align="center">x</td></tr><tr><td><strong>File Upload</strong></td><td align="center">x</td><td align="center">x</td><td align="center">✔</td><td align="center">x</td></tr></tbody></table>

## **Create a new form**

* To create a new form, click the ***Add*** button.&#x20;
* First, choose a name for the form and select its type.&#x20;
* You can then select an existing form in the *Created from* field.&#x20;
* The last thing to select when creating a new form is its location in the *(if you do not select a location in the directory the form will be added to the default folder - All Forms)*.&#x20;
* Then just click on the **Create** button.

A new form editing panel will appear. While editing a form, you can change the **title**, **location,** and **type** (editor/Iframe) of the form. It is also possible to switch among different languages for the form.

{% hint style="success" %}
*The language of the chat form is controlled by the language set in the client's browser. In addition to your basic language, we recommend setting a foreign language, preferably English (default value).*

***The Model situation** would then look like this: your company has set up a form in Czech and English. A client with a German browser localization enters the chat, and because your form is not set to German, the English form is displayed.*
{% endhint %}

### **Iframe**

Want to use custom forms in WebChat? When creating a new form, click on the Iframe tab and enter the source address of your custom form in the URL field. You can use it for all types of forms: entry, feedback, offline, and call script.

### **Form Editor**

First, let's look at the *Forms Editor*. Click on the *Add* button and select one of the four types of fields from which you can compose the form.

## **Form field types:**

### **Text** <a href="#aaa" id="aaa"></a>

Classic text field supporting rich text format. You can change font size, style, and line spacing or add bullets and hyperlinks.

### **Field** <a href="#aab" id="aab"></a>

First, name the field type by clicking the pencil icon. Then choose one of the 5 types that the field can have:

* **text line** - line for inserting shorter text, such as first and last names.
* **text field** - field for inserting and editing longer text. Click on **Preview** to immediately see the changes you are making to the form. For example, you can adjust the size of the text box by moving the bottom right corner.
* **e-mail** - the field for inserting an e-mail address checks the format of the address.
* **number** - a field that only allows the entry of digits.
* **phone** - field to enter a phone number. Checks the standard phone number format.

Finally, assign a parameter in the right corner of the *Pole*. You can choose from the preset parameters or add your own.

{% hint style="success" %}
*You can also mark the field as Mandatory. If the client sees a mandatory field in the form, they cannot confirm the form submission without filling it in. When you are finished with your edits, click the Save button.*
{% endhint %}

### **List** <a href="#aac" id="aac"></a>

Another option is to insert a *List*. First name the list and assign it a parameter. You can choose from two types of lists: *radio button* or *dropdown list*. To add options to the list, click the **+** button. You can then check your edits in the preview before saving the form. As with *Field*, selecting a value from the list can be made mandatory.

### **GDPR** <a href="#aad" id="aad"></a>

The last field type is *GDPR*, which is used to grant client consent. The field contains a checkbox and preset text.&#x20;

{% hint style="warning" %}
*You can edit the consent text at any time in GDPR. **The GDPR field is always mandatory.***
{% endhint %}

### **Rating** <a href="#aae" id="aae"></a>

In the feedback form, you can select one of four forms of *evaluation* of the session. You can check the visualization of the selected evaluation in the chat preview on the right side. You can select:

* **Thumbs**,
* **Stars**,
* **Smiles**,
* **NPS** (Net Promoter Score) - using a scale of 0-10 instead of the standard scale of 1-5.

{% hint style="info" %}
*Once you select and save one of the rating options, the other three disappear from the list.*
{% endhint %}

### **Feedback**

You can also insert a *feedback* field for the client in the output form. Each user can adjust the size of the field to suit their needs by scrolling to the bottom right corner of the component.

### **Transcript** <a href="#aaf" id="aaf"></a>

The last field type you can insert into the output form is *Transcript*. This field allows the client to have a text transcript of the conversation sent to their email. The *E-mail address of the client is automatically pre-filled if they have previously entered it in the chat entry form.*

{% hint style="success" %}
*You can change the order of fields in the form at any time by dragging and dropping them. You can change the position by grabbing a field in the upper left corner and dragging it with the mouse.*
{% endhint %}

## **How to set a form to a WebChat widget** <a href="#jpf" id="jpf"></a>

You've created a new form and it's time to bring it to life. To set up the form at the widget level chat, do the following: ***Settings -> WebChat -> Select the WebChat** widget **-> WebChat -> Chat Forms***, where you select the *entry*, *feedback,* or *offline* form by name. Don't forget to **save** your settings.
