﻿# Create an app

> [HTML Version](360007235031.html)

There are two ways to create an app:

- [Create an app from scratch](#from_scratch).

- [Import an .e365 file with an app](#import_from_file).

````
начало внимание

````
Only users included in the [Administrators](360006871932.md) group can create apps.

````
конец внимание 

## ````
Create an app from scratch

1. In the left menu of a [workspace](360007990371.md), click **Add**.

**(hmfile_hash_0d45ccca.png)**

2. In the window that opens, click on the **App** area.

**(hmfile_hash_54d5afbb.png)**

3. Fill out the fields with information about the app.

**(hmfile_hash_e9fa1bbc.png)**



- **App Name\***. Enter a name that will be displayed in the left menu of the workspace.

- **App URL**. A link to the app that is formed automatically based on the app name. While you're creating the app, you can edit this link. It will be used in the future to access the app.

- **Item Name**. Specify the name of the [button for adding a new app item](360016427291.md#element_page_create) that will be displayed on the app page.





- **Type**. Select the type of new app.

	- **Standard**. Standard app that stores data entered by users.

	- **Event**. An app that allows you to create events in the [calendar](360026962272.md).

	- **Document**.** **An app intended for creating documents. [Document](360009923631.md) type apps have special features that facilitate document management. They allow you to [upload, view, and edit a file on a document’s page](360009671252.md), [register documents](app-registration-settings.md#registration), and reserve registration numbers.

Please note that it is impossible to change an app type after creation.

- **Visibility**. Specify who has [access to the app](360009919211.md). You can [change](360009919211.md) these settings later and select groups of employees who will be able to work with the app.



	- **Visible to everyone**. All the system users will be able to see the app.

	- **Only to administrators**. Only the users included in the [Administrators](360006871932.md#administrators) group will be able to see the app.

- **App Icon**. An image assigned to the app that users will see in the workspace left menu. Icons help users find apps faster.

- **Show**.** **Select how app items will be displayed: as tiles or as a table.

4.  After filling out the fields, click **Create**.

5. The next step is configuring the app form.

The **Form Settings **window is divided into two areas: on the left you can see the [app item](360016427291.md) form, and on the right is the properties panel. You can find more information about all the property types in [System data types](360009707032.md).

**(hmfile_hash_8ad85c8e.png)**

To set up the form, drag the properties from the panel and drop them on the form. You can also drag and drop them to rearrange the order.

Each property on the form is a field that users will need to fill in when creating a new app item. Specify which fields will be required **(required.png)**.

In the left part of the window the properties are collapsed. Click on a property to expand it and view all of its options.

**(hmfile_hash_b3502c53.png)**

You can edit:

| | |
|------|------|
| **(hmfile_hash_b5c55856.png)** | The property's name that will be displayed on the forms for creating, viewing, and editing an app item. |
| **(hmfile_hash_fe4f64cf.png)** | The property's code that will be used when working with the API.  |
| **(hmfile_hash_9985403a.png)** | Additional information that clarifies how to fill in the field on an app item form._ _For example, “Enter a phone number as +1 5ХХ ХХХ ХХ ХХ”. |
| **(hmfile_hash_11308794.png)** | If you select this option, this field will be used as a parameter in [search](360009669952.md).** ** |
| **(hmfile_hash_709071da.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 a currency, for example, USD. Learn more about properties and their settings in [System data types](360009707032.md). |


To delete a property, click the recycle bin icon in the property row. Please note that the property marked with the  **(key.png)** icon is the [key variable](360007679591.md#ways). It cannot be deleted because it is used to generate app item names. 

Learn more about form settings in [App item form](360009918011.md).

6. After configuring the form, click **Save**.

**(hmfile_hash_0a263bf9.png)**

By default, the form you configured will open when a user is creating, viewing, or editing an item of the app. If you want to set up different forms for creation, viewing, and editing, use the [Advanced mode](360028941032.md).

## Import an app from an .e365 file

When you upload an app to a company, the business processes, groups, and statuses configured in the app will be imported from an **.e365** file.

To upload a file, follow these steps:

1. In the workspace's left menu, click the **+Add **button and select **Upload File**.

**(hmfile_hash_3e080014.png)**

2. Select the **.e365** file to upload from your PC or system files and click **Next**.

**(hmfile_hash_b2e65d24.png)**

If you upload an app created or modified in a newer version of the system (e.g., 2024.4) than your current version (e.g., 2024.1), a warning message will appear. The import may fail or the app may not work properly because the newer version may have changes that are incompatible with your version. Select whether to cancel or continue the import process.

3. In the window that opens, you can edit the app data if needed.

**(hmfile_hash_b7877b25.png)**

- **Name\***.** **Specify the app name that will be displayed in the workspace left menu.  

- **App URL\***.** **The link is generated automatically, based on the app name. It is used to quickly access the app.

- **Description**. This field displays the information which specified when [exporting the app](360009669292.md).

4. When you finish, click **Next**.

5. In the next step, configure the initial settings of the app. Add users to [groups](360007331871.md)** **and assign [roles](360007331871.md#role). To do that, click on the magnifying glass icon and select a job position or an employee from the list. 

6. Click **Install**.

The app that you're importing will be checked for errors. If an error is found (for example, if the structure of the user groups is invalid), you will see a notification. In this case, the app cannot be added to the company.

If non-critical errors are found, for example, variable inconsistencies in [document templates](360026936731.md), you will see a warning. You can continue installing the app.

7. When the app is successfully installed, click **Open App** in the provided window.

In the app, you can create [app items](360016427291.md) and [business processes](360009921131.md), [edit forms](360009918011.md) and configure [statuses](360009920611.md). Moreover, you can change the app name, the name of its items, its icon, and its description. To learn more, read the [App settings](360007708691.md) article.