﻿# App item forms

> [HTML Version](360009918011.html)

A** form** is the layout of an app item’s page. When you configure a form, you specify what the page of an item will look like: what kind of data it will display, what information the user will have to enter, and which fields can or cannot be edited.

You can configure forms when [adding a new app](360007235031.md#from_scratch) or when [editing an existing one](360009918011.md#edit_form). A configured form is used for creating, viewing, and editing an [app item](360016427291.md). 

Here is what an app item form may look like:

** (app-item-forms-1.png)**

Forms have fields that need to be filled out, like name, position, phone number, etc. In addition, you can add tables, lists, and radio buttons that allow the user to select one or more options.

## Configure form fields

You can add an unlimited number of fields to the form, defining their order and settings.

````
начало внимание

````
Only users included in the** **[Administrators](360006871932.md) group can configure forms.

````
конец внимание

````
There are two ways to open form settings:

1. In the left menu of a workspace, click the **(hmfile_hash_f96bd8e3.png) **icon next to an app’s name and select **Form Settings**.

**(hmfile_hash_1799ee00.png)**

2. On an app page, click on the name of any app item. In the window that opens, click the **Form Settings **link.

**(hmfile_hash_b70cdd24.png)**

The **Form Settings **window will open. It contains two areas: on the left you can see the [app item](360016427291.md) form, while on the right is the properties pane. You can find more information about all types of properties in the [System data types](360009707032.md) article.

Each property placed in the area on the left is a field on the form. Drag and drop properties from the pane on the right to add the fields you need.

**(hmfile_hash_bfc03110.png)**

You can also drag and drop fields on the form to rearrange them.

After adding all the fields you need, you can start configuring them. 

In the left part of the window, fields are collapsed. Click on a field to expand it and define its parameters.

**(hmfile_hash_8f2a26a4.png)**

You can edit:

| | |
|------|------|
| **(hmfile_hash_3e852661.png)** | The field’s name that will be displayed on the pages for creating, viewing, and editing an app item. |
| **(hmfile_hash_6eae26ce.png)** | The field’s code used when working with the API.  |
| **(hmfile_hash_ebecd74f.png)** | Additional information that clarifies how to fill out the field on an app item form._ _For example, “Enter your mobile phone number in the following format: +1 5ХХ ХХХ ХХ ХХ”. |
| **(hmfile_hash_f640f7de.png)** | If you check this box, the field will be used as a parameter for [search in the app](360009669952.md). |
| **(hmfile_hash_f03db889.png)** | Each property has a set of parameters. For instance, for a **Phone** **number** type property, you can specify its type: home, work, mobile, etc. For a **Money** type property, you can select the currency, for example, USD. You can learn more about properties and their settings in the [System data types](360009707032.md) article. |


If you need to make a field required, click the **(hmfile_hash_c7fb650f.png)**icon next to its name.

Required fields are marked with** (required.png)**on the form. If a required field is not filled out, the user will see a warning when saving the item.

**(app-item-forms-required.png)**

To delete a field, click the **(trash.png) **icon.

**(hmfile_hash_fa5225e8.png)**

After configuring the form, click **Save**.

**(hmfile_hash_34b92d5b.png)**

If you want to set up different forms for creating, viewing, and editing app items, switch to the [Advanced Mode](360028941032.md). 