> For the complete documentation index, see [llms.txt](https://docs.offshoresms.com.au/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.offshoresms.com.au/asset-profiles/custom-forms/create-and-edit-a-custom-form.md).

# Create and Edit a custom form

How to build and manage your custom form.

## Create a New Custom form

1. From the Assets home page, select the Custom Forms tab, then select "Add a Custom Form" at the bottom of the page.
2. You can choose to either create a new **asset unique form**, or include a link to **Fleet Custom Form**. (see [Fleet Content](/your-fleet/fleet-content.md) for more information on fleet level content).
3. Select **"Create a New Custom Form"** and give the form a title (and optional description) in the pop-up window, then click "Add".
4. You will enter the Edit mode for the form:

***

## Edit your Form

1. Select the form to edit from the list, then select Edit Custom Form.
2. Select **"Add a Field"** and choose from the options. (see [Key Features and functions](/asset-profiles/custom-forms/key-features-and-functions.md)for information about each field type).
3. Give the field a **label** (usually a prompt or question. I.E. "Weather forecast") and some optional prompt text, response options for drip down or checkbox fields, or other required content, then select **"Add to Fields"**.
4. Once you have multiple fields, you can **drag and drop to re-order**, select the **plus icon on the right** to **add a field below** the current field, or do any of the following:

***

## Setting conditional fields:

{% hint style="info" %} <mark style="color:blue;">A field that is conditional on the responses from previous fields will</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**only appear**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">for the app user if the</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**response conditions are met.**</mark>

<mark style="color:blue;">Fields may only be conditional on the responses from</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Checkbox**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">or</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Dropdown List**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">fields.</mark>

<mark style="color:blue;">A field may have up to 3 conditions applied, and the user can choose whether either</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**ANY**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">or</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**ALL**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">conditions must be met for the field to be displayed</mark>
{% endhint %}

#### Example:

A checkbox field might be "**Select the PPE Required**", with some items listed as potential responses as well as the option "**Other**". If the user selects "Other", a text response field will appear, allowing the user to write a description of the other PPE required.&#x20;

#### To do this:

<figure><img src="https://1114421164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbC6kObUPlvFTCbPDBzwD%2Fuploads%2F5BMOMeN1S7iGH6mJPTpM%2FCustom%20Forms%20-%20Conditional%20field.png?alt=media&amp;token=398eeafa-f8ce-448e-abfe-8d121c9078c0" alt=""><figcaption></figcaption></figure>

1. On the tile for the field, select **"Add a condition"** then **"Add New Condition"** from the pop-up window.
2. Select the **field** and the **response conditions** that the dependant field is to rely on.
3. Add **additional conditions** (you can select whether the dependant field will appear if either **ANY or ALL of the conditions** are met).
4. Make sure you select **Save Conditions.**
5. Click the magenta **conditions button** to view any existing conditions

***

## Making a field mandatory

{% hint style="warning" %} <mark style="color:orange;">**This will mean the custom form cannot be submitted by the user unless all mandatory fields have been answered.**</mark>&#x20;
{% endhint %}

To make a field mandatory, in the field's Edit window, select **"Make this Field Mandatory"** at the bottom of the window.&#x20;

A red star indicates the field is Mandatory, and the Field title appears in red text in the app.&#x20;

<figure><img src="https://1114421164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbC6kObUPlvFTCbPDBzwD%2Fuploads%2FgV1QSuza46vTgHP1d64I%2FCustom%20Forms%20-%20Mandatory%20Fields.png?alt=media&amp;token=0e04875a-c104-4bd8-8506-f365d39b2ba4" alt=""><figcaption></figcaption></figure>

## Allow multiple responses to a text field

{% hint style="warning" %} <mark style="color:orange;">**Only Text Box fields have the option to allow multiple responses.**</mark>
{% endhint %}

I.E. The field title may be "Passenger Names", and the user could continue to input multiple responses.&#x20;

To do this, in the Text Box field edit window, select "Text answers can be repeated".

***

## Display multiple fields on the same page

By default, each field will appear in the app on a separate page, and the user has to click Next to navigate to.&#x20;

By **indenting the field**, it will display below the field above it.&#x20;

Indenting multiple consecutive fields displays them all under the last field that is not indented.

To do this, **in the field tile, select "Indent**".

***

## Duplicate a field

From the field tile, select the Duplicate Icon on the right end of the tile.&#x20;

## Re-oreder

Simply drag and drop each field to adjust the order.