> For the complete documentation index, see [llms.txt](https://help.dollarlabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/advanced-form-builder.md).

# The advanced form builder

Build a wholesale application with pages, branches and stop rules in the advanced form builder, and set up its access, limits, tags and translations.

The advanced form builder lays your application out on a canvas. Use it when different buyers should see different questions: put questions on pages, group them in branches that open on an answer, and stop applicants who don't qualify.

{% hint style="info" %}
**Plan:** The advanced form builder is available on the Founding plan.
{% endhint %}

## Choose a builder

1. Go to **Wholesale Forms** and select **Create form**.
2. In **Create a form**, choose a builder:
   * **Simple form builder** — a guided one-page editor for a standard application. See [Build your form](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/build-your-form.md).
   * **Advanced form builder** — pages, branches with their own rule, bulk edits and stop rules.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-8156eec8aeb18ad0837c725629784eea9d5129e8%2Fforms-choose-builder-annotated.png?alt=media" alt="Create a form dialog with the Simple form builder and Advanced form builder cards." width="672"><figcaption><p>Pick the builder when you create the form. You can’t switch later.</p></figcaption></figure>

{% hint style="warning" %}
**You can't change the builder later.** A simple form always opens in the simple builder, and an advanced form always opens in the advanced builder. To move a form to the other builder, create a new form there and copy your questions across.
{% endhint %}

The forms list doesn't show which builder a form uses. Select the form's row and it opens in the right one. If you made a form in our earlier canvas builder, it still opens in that editor.

## The layout

The builder opens full screen with three panes:

| Pane                  | What it does                                                                                      |
| --------------------- | ------------------------------------------------------------------------------------------------- |
| **Outline** (left)    | Every page, branch and field in order. Drag a row to move it; the blue line shows where it lands. |
| Canvas (centre)       | The same form as cards and wires. Select a card to edit it.                                       |
| **Inspector** (right) | The settings of what you selected. **Settings** in the toolbar swaps it for **Form settings**.    |

The toolbar runs left to right: the form name, the **Enabled** / **Draft** switch, **Tidy up**, undo and redo, help, **Settings**, **Preview**, **Add field**, **Add branch**, **Add page** and **Save**.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-988630018caa613b811642f60836d5b995dab38b%2Fforms-advanced-layout-annotated.png?alt=media" alt="Advanced form builder showing the Trade account application form with the outline, the canvas of fields and branches, the Branch rule inspector and the toolbar."><figcaption><p>The advanced builder: outline on the left, canvas in the centre, Inspector on the right.</p></figcaption></figure>

A new advanced form starts with one page, **Page 1**, holding one required **Email** field. That email creates the applicant's customer account (see [The account email](#the-account-email)).

### Working on the canvas

* **Select** mode: drag a box over cards to pick several. **Pan** mode: drag anywhere to move the canvas.
* Where a card sits on the canvas is only layout. **The question order comes from the outline**, or from the grey wire between cards.
* Each card has wire handles. Drag the **blue dot** onto another card to show that card only on an answer. Drag the **orange dot** to make it required on an answer. Drag the **grey dot** onto the card that should come next. Select a wire to edit its rule; drop a wire end on empty canvas to remove the rule.
* **Tidy up** rearranges the cards neatly. It changes the layout only, never the form. If nothing needs moving, you see **Already tidy**.
* **Undo** and **Redo** keep the last 50 changes. Use Cmd-Z (Ctrl-Z on Windows) to undo and Cmd-Shift-Z or Cmd-Y to redo, until you save.

On a narrow screen, the toolbar scrolls. **Tidy up** and the help link move into **More actions**, and **Show outline** opens the outline.

## Add fields and pages

* **Add field** opens the field picker. It has the same field types as the simple builder, grouped under **Most used**, **Choice**, **Details** and **Layout**. Type in **Search field types** to find one. **Yes or no** adds a Choose one field with Yes and No.
* On a field card, **Add** puts a new field straight after it. **Duplicate** and **Delete** are on the card too.
* **Add page** adds a page after the last one. Pages are named **Page 2**, **Page 3** and so on; select a page to rename it.
* **Add branch** adds a group of fields that shows only when its rule matches. See [Conditional logic & multi-step](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/conditional-logic-and-multi-step.md).

{% hint style="info" %}
The simple builder's **Common wholesale fields** shortcuts are not in the advanced builder. Add a **URL** field for a website, or a **File upload** for a resale certificate.
{% endhint %}

To change several fields at once, Shift-click or Cmd-click (Ctrl-click) them, or drag a box over them in **Select** mode. The Inspector shows **N selected**. From there you can set **Answer** for all of them, **Move to** another page or branch, **Group with a rule**, **Duplicate**, **Delete**, or **Show these fields when** a rule matches.

## Field settings

Select a field to open it in the Inspector. You see only the settings that the field type supports.

| Setting                                   | What it does                                                                                                                                                                                                                           |
| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Label**                                 | The question the applicant sees.                                                                                                                                                                                                       |
| **Type**                                  | Changes the field to another type. Rules that read the old options are removed, and **Field type changed** appears if settings were dropped.                                                                                           |
| **Answer**                                | **Optional**, **Required**, or **Required if…** to require it only on an answer. See [Required if](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/conditional-logic-and-multi-step.md#required-if).          |
| **Placeholder**                           | Grey example text inside the empty box, for example `e.g. name@company.com`. For a **Dropdown**, it is the first row shown until an option is picked. Name, short and long answer, email, URL, phone, number and dropdown fields only. |
| **Help text**                             | A hint under the field.                                                                                                                                                                                                                |
| **Options**                               | The choices of a **Dropdown**, **Choose one** or **Choose many** field. **Add option** adds one. Renaming an option also updates the rules that use it.                                                                                |
| **Validation**                            | Limits checked as the buyer types and again when they submit. An empty box means the limit is off.                                                                                                                                     |
| **Move up** / **Move down** / **Move to** | Moves the field, or sends it to another page or branch.                                                                                                                                                                                |
| **Stop the form when…**                   | Stops applicants who give a certain answer. See [Stop rules](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/conditional-logic-and-multi-step.md#stop-rules).                                                 |
| **Show this field when…**                 | Shows the field only when a rule matches. See [Field rules](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/conditional-logic-and-multi-step.md#field-rules).                                                 |

**Consent** fields are always required, so they have no **Answer** setting. **Section header** and **Description** fields take only their **Heading** or **Text**.

**First name** and **Last name** name the customer created for the applicant, whatever you call the field.

### Validation by field type

| Field type                                       | Validation                                                                                                                                   |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Short answer, Long answer, First name, Last name | **Minimum length**, **Maximum length**                                                                                                       |
| URL                                              | **Maximum length**                                                                                                                           |
| Email                                            | **Allowed email domains**, **Blocked email domains** (comma separated)                                                                       |
| Number                                           | **Minimum value**, **Maximum value**, **Whole numbers only**, **Fewest digits**, **Most digits**                                             |
| Date                                             | **Earliest date**, **Latest date**                                                                                                           |
| Phone                                            | **Expected phone format**: **Any (loose check)**, **International (e.g. +14155552671)** or **Custom regex** with a **Phone pattern (regex)** |
| Choose many                                      | **Fewest selections**, **Most selections**                                                                                                   |
| File upload                                      | **Max file size (MB)** and **Accepted file types**                                                                                           |

**File uploads** take up to 3 files per field, up to 10 MB each, even if you set a higher size. Under **Accepted file types**, tick any of **Any image**, **JPEG (.jpg)**, **PNG (.png)**, **GIF (.gif)**, **WebP (.webp)**, **PDF (.pdf)**, **Word (.doc)**, **Word (.docx)**, **Excel (.xls)**, **Excel (.xlsx)** or **CSV (.csv)**. Leave them all unticked to accept images and PDFs.

### The account email

The app creates or matches the applicant's Shopify customer from one email answer. On an **Email** field, tick **Use this email to create the customer account** to choose it. With only one Email field, that field is used automatically. Ticking the box also makes the field required.

Other email answers are still saved with the submission.

## Form settings

Select **Settings** in the toolbar. **Form settings** replaces the Inspector. Each row shows a summary; select it to edit.

| Section                                | What it does                                                                                                                                                                                                                                |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Form status**                        | **Enable form** puts the form live. Off means applicants can't see or submit it. Same as the toolbar's **Enabled** / **Draft** switch.                                                                                                      |
| **Storefront**                         | Whether the form is on your storefront, the **Form ID** with a copy button, and **Add to theme**. See [Add the form to your store](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/add-the-form-to-your-store.md). |
| **Form name** and **Form description** | Shown to applicants. You see a warning if another form already uses the name, but you can still save.                                                                                                                                       |
| **New field defaults**                 | **Make every new field required by default**.                                                                                                                                                                                               |
| **Access rules**                       | Who can see the form.                                                                                                                                                                                                                       |
| **Submit rules**                       | Checks across fields, made when the applicant submits. See [Submit rules](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/conditional-logic-and-multi-step.md#submit-rules).                                       |
| **Submission limits**                  | How often a buyer can apply.                                                                                                                                                                                                                |
| **Automations**                        | Tags added when you approve or decline. See [Approvals & automations](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/approvals-and-automations.md#automatic-customer-creation-and-tagging).                       |
| **Branch tags**                        | Extra approval tags for buyers who came down each branch.                                                                                                                                                                                   |
| **Translations**                       | **Edit** opens the form's translations. See [Translate your form](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/translate-your-form.md).                                                                         |

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-33b87bac8fbb41d5a2963161bc9499fc65e9e472%2Fforms-advanced-settings-annotated.png?alt=media" alt="Form settings panel with Form status, Storefront with the form ID and Add to theme, rows for name, description, field defaults, access rules, submit rules and limits, and Automations with a wholesale tag." width="457"><figcaption><p>Form settings: status, storefront, the other settings and Automations in one panel.</p></figcaption></figure>

### Access rules

Access rules hide the form from visitors who don't match. With no rules, everyone can see it. Select **Add rule** and choose what to check: **Customer is logged in**, **Customer is B2B**, **Customer ID**, **Customer company**, **Customer tag**, **Customer orders count** or **Cart attribute**. Choose whether a visitor must match **any** or **all** of the rules.

**Message shown when access is denied** replaces the block's access message for this form.

{% hint style="info" %}
Access rules control who **sees** the form. To stop guests **submitting** it, use **Submission limits** and turn on **Require the visitor to be logged in**.
{% endhint %}

### Submission limits

* **Require the visitor to be logged in** — only signed-in customers can submit. If your access rules let guests see the form, they can fill it in but are turned away at the end. The panel warns you when that is the case.
* **Max submissions per customer** — appears when sign-in is required. Leave it blank for no limit.
* **If they already have a pending submission** and **If a previous submission was declined** — choose **Allow**, **Block on this form** or **Block on any form**.

Guests can have one live application per email address.

### What the builder doesn't set

The submit button text, success message, error messages and styling belong to the [Wholesale Form block](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/add-the-form-to-your-store.md#settings) and to **Customize → Wholesale form**. The app creates the customer with their email, first and last name, and tags. It does not create a Shopify B2B company or fill other customer fields.

## Preview

**Preview** opens the form as a buyer sees it. Fill it in: branches open and close, pages are skipped and stop messages appear exactly as they will on your store. **Back** and **Next** move between pages. Nothing you enter is saved.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-edb666c4aede32dc58a62a9b4fcffad2bf418e84%2Fforms-advanced-preview-annotated.png?alt=media" alt="Form preview, Page 1 of 1, with Art school or studio selected and the question How many students do you teach? shown." width="670"><figcaption><p>Preview opens branches as you answer. Here the art-school question appears and the Shop details page is skipped.</p></figcaption></figure>

## Save

Select **Save**. The app checks the form first. If something would break it on your store, **Fix these before saving** lists each problem with a link to it, and nothing is saved until you fix them.

The checks include:

* **Add an email field to save this form** — the form needs an Email field to create the customer.
* **Make the customer email field required** — the account email can't be optional.
* **Move the customer email field out of its branch** — the account email can't be in a branch or have a rule, because every applicant must answer it.
* A branch with no rule. A branch without a rule would show to everyone, so it is blocked until you give it one.
* A rule with no value, such as **Pick a value, or this form can't be saved.**
* A stop rule set to show a message, with no message.

The email checks are skipped when only signed-in customers can submit: **Require the visitor to be logged in** is on, or your access rules require **Customer is logged in**. The app then uses the signed-in customer's own account email when the form has no email answer.

When the save works you see **Form saved**. **Saved with warnings** means it saved, but something needs a look, such as another form with the same name.

## Related

* [Conditional logic & multi-step](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/conditional-logic-and-multi-step.md) — field rules, branches, page rules and stop rules
* [Translate your form](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/translate-your-form.md)
* [Approvals & automations](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/approvals-and-automations.md)
* [Add the form to your store](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/add-the-form-to-your-store.md)
