> For the complete documentation index, see [llms.txt](https://docs.insurgrid.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.insurgrid.com/get-started/dashboard/form-builder.md).

# Form Builder

Build a branded intake form, share it as a link, and get every submission back as a client in your dashboard.

Form Builder lets you make your own intake forms without code. Use it for quote requests, renewal check-ins, or collecting driver and vehicle details. You can also have the prospect connect their current carrier so InsurGrid pulls their policy for you.

Each form gets a shareable link. Prospects fill it in on their phone or computer, and every submission lands in your dashboard as a client with their answers attached.

**You'll need:** an InsurGrid dashboard login with the **Admin** or **Owner** role. Other team members can view forms but can't edit them.

{% hint style="info" %}
Building forms from your own product instead? See the [Forms API](https://docs.insurgrid.com/intake-forms/forms.md) and [Embed the form builder](https://docs.insurgrid.com/intake-forms/builder-sessions.md).
{% endhint %}

***

## Where to find it

Your forms live on the **Links** page, alongside your other shareable links. From there you can create a new form or open an existing one in the builder.

If you don't see the option to create a form, ask your InsurGrid contact to enable Form Builder for your account.

## Create a form

### 1. Pick a starting point

When you create a form, choose how to start:

* **A template**: a ready-made form you can edit.
* **ACORD-driven**: pick an insurance line and InsurGrid builds a form that asks for what the matching ACORD forms need. These forms carry an **ACORD-Ready** badge. Their question types and step structure are fixed so the answers map cleanly onto ACORD fields.

Give the form a name when prompted. You can rename it at any time by clicking its name at the top of the builder.

### 2. Lay out your steps

The builder has three panels:

* **Left: steps.** Each step is one screen of the form. Click **+ Add step** to add one, and drag to reorder.
* **Centre: phone preview.** This shows what the prospect sees, updating as you edit.
* **Right: step editor.** Edit the selected step.

The left panel also has the **carrier flow** toggle. Turn it on to add the built-in steps that let the prospect choose and log in to their current carrier. InsurGrid then pulls their policy automatically. These steps are Carrier Select, Carrier Login, Data Retrieval and Confirm Details.

### 3. Add questions

In the step editor, set the step's headline, description and button text, then add questions:

| Type                                    | Use it for                                                          |
| --------------------------------------- | ------------------------------------------------------------------- |
| Short Text / Long Text                  | Names, notes, free-form answers                                     |
| Single Choice / Multi Choice / Dropdown | Picking from options you define                                     |
| Date, Number, Email                     | Typed answers with validation                                       |
| Address                                 | A full postal address                                               |
| Document Upload                         | A driver's licence, declaration page, policy document or other file |
| Data Table                              | Repeating rows, for example several vehicles                        |

For each question you can:

* mark it **Required**;
* drag it to reorder;
* map it to a client field: **Full name**, **Email** or **Phone**. This fills in the client record when the form is submitted.

To collect several drivers, add the **Drivers** preset. It adds a repeatable drivers section.

### 4. Add logic (optional)

Click **Configure logic** to change the form based on earlier answers. Each rule has conditions (**Match ALL** or **Match ANY**) and an action:

* Show a question
* Hide a question
* Require a question
* Skip to step
* End the form

If a rule is broken, for example it points at a question you've deleted, you'll need to fix it before you can save.

### 5. Brand it

Open **Branding** to set the button colour (or **Reset to agency color**). You can also choose whether to show your agency logo, your headshot, the "Used by N insurance shoppers" pill and the welcome decoration.

### 6. Set up notifications (optional)

Open **Notifications** and turn on **Send auto-response email to prospect** to email prospects when they submit. This needs a question mapped to the **Email** field.

### 7. Save and publish

Click **Save**. New forms start as a **Draft**, which prospects can't open.

When you're ready, click **Publish**. The form goes live at its shareable link, and you can keep editing afterwards. A form needs at least one question step, a contact-info step, or the carrier flow before it can be published.

The status dot next to the form name shows where it stands: **Draft**, **Active** or **Archived**.

## Share the form

Copy the form's link from the Links page and send it however you like: email, text, your website, or social media.

Prospects see your branding and fill in the form one step at a time. They can upload documents: images up to 10 MB and PDFs up to 75 MB. When they finish, they see a confirmation page.

## See submissions

Each submission creates a client in your dashboard. Open the client and look in their **Overview** tab to see the form answers. If the prospect connected their carrier, their policy data appears on the client as well.

## Manage forms

From the Links page you can:

* **Duplicate** a form to use it as a starting point;
* **Archive** it to take it offline, and **Unarchive** it to bring it back;
* **Delete** it. This can't be undone, and the link stops working immediately.

{% hint style="warning" %}
Archiving or deleting a form breaks any link you've already sent out. Archive, rather than delete, if you might need it again.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.insurgrid.com/get-started/dashboard/form-builder.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
