# Creating a Form

### Creating a Form

To create a form, go to Forms in the top navigation and click **New Form**. Give your form a name and an optional description, then select your form type.

<div align="left"><figure><img src="/files/RfhivyRjqUYOXOduHI83" alt="Screenshot of the Create Form dialog in UbiQuity showing a Form name field and an optional Description text area, with Next and Cancel buttons."><figcaption><p>The Create Form dialog where you enter a name and optional description for your new form.</p></figcaption></figure></div>

***

### Form Types

<figure><img src="/files/gjIgx4MvZHFjXt1Ir3tn" alt="Screenshot of the Select Form type dialog in UbiQuity showing three options: Update for existing contacts, Subscribe for new contacts, and Subscribe/Update for both, with Create form and Cancel buttons."><figcaption><p>The form type selector showing the three available form types — Update, Subscribe, and Subscribe/Update.</p></figcaption></figure>

UbiQuity has three form types to choose from at creation:

**Subscribe** adds new contacts to your database. If your database has mandatory fields without default values, those fields must be included on the form. Any unique fields should also be included.

**Update** is used where a contact already exists in your database. You would usually link to an Update Form from a UbiQuity email. When the contact clicks the link, the form loads pre-populated with their details, which they can then edit and submit.

**Subscribe/Update** combines both. If the link is placed in a UbiQuity email it behaves as an Update Form. If it is placed on a website it behaves as a Subscribe Form. If your database has unique fields and a match is found, the existing contact is updated. Otherwise a new contact is added.

You can change the form type at any time after creation.

***

### Opt Out Forms

An Opt Out Form gives contacts a way to unsubscribe from your emails. Rather than a separate form type, it is configured by adding the Opted Out field to an existing form.

To set up an Opt Out Form, your database must first be configured for sending email. Once configured, an Opted Out field will be available in your database. Add this field to your form, then include a link to the form in your UbiQuity email template. When a recipient clicks the link and submits the form, their Opted Out field is updated and UbiQuity automatically excludes them from future mailouts.


---

# 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.ubiquity.co.nz/documentation/data-capture/forms/creating-a-form.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.