> For the complete documentation index, see [llms.txt](https://orbit-b2b.gitbook.io/orbit-b2b-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://orbit-b2b.gitbook.io/orbit-b2b-docs/b2b-registration/form-builder.md).

# Build your registration form

The form builder lets you choose which fields appear on your B2B registration form, set them as required or optional, and customize the form's appearance.

***

## Open the form builder

1. Go to **Registration** in the app menu
2. Click **Form settings** or **Edit form**
3. The form builder opens in a fullscreen editor

***

## Built-in fields

The form ships with a standard set of fields — name, email, phone, Tax ID, address, website, message, and more. These are **always available on every plan** and **cannot be deleted or have their type changed**. You can:

* Enable or disable them (the eye icon)
* Mark them required or optional
* Set half or full width
* Give them your own label and placeholder (per language)
* Drag to reorder

***

## Available field types

Built-in fields use these types, and custom fields (Advanced plan) can be created with any of them:

| Type               | Use case                                                            |
| ------------------ | ------------------------------------------------------------------- |
| **Text**           | Short text input (name, job title)                                  |
| **Textarea**       | Multi-line text (message, notes)                                    |
| **Email**          | Email address with validation                                       |
| **Phone**          | Phone number with country code selector                             |
| **Number**         | Numeric input, with optional min / max / step                       |
| **Dropdown**       | Single choice from a predefined list                                |
| **Radio**          | Single choice shown as radio buttons                                |
| **Checkbox**       | A single consent tick (e.g. "I agree to the terms")                 |
| **Checkbox group** | Multiple choices the customer can tick                              |
| **Date**           | Date picker, with optional earliest / latest limits                 |
| **File upload**    | Business license, tax certificate, etc. — uploaded to Shopify Files |

***

## Adding your own fields (Advanced plan)

Creating **custom fields** requires the **Advanced plan or above**. Free and Essential merchants can still use every built-in field.

1. Click **+ Add element** at the bottom of the Form fields list
2. Choose the field type
3. Set the label, placeholder, and whether it's required
4. Configure the type-specific options (list options, number range, date limits, or file rules)
5. Drag to reorder; delete with the trash icon on the field's row
6. Save

Each custom field automatically gets a stable ID generated from its label (for example **Reseller license** → `reseller_license_ab12`). The ID follows the label until you save, then it's frozen so existing submissions keep their reference even if you rename the field later.

See [Custom fields & file upload](/orbit-b2b-docs/b2b-registration/custom-fields.md) for the full details.

***

## Field width

Each field can be set to **Full width** or **Half width**. Half-width fields appear side-by-side (e.g. first name and last name).

***

## Form design settings

Customize colors, fonts, and the submit button label to match your store's style.

***

## Company section labels

When a customer picks **"A company"** on the *I'm registering as* toggle, a dedicated **Company information** section appears with its own fields (company name, tax ID, and the company's HQ address). Its texts are managed separately from your regular form fields — find them in **Content Settings**, under **Company section labels**:

| Text                              | Where it appears                                                                          |
| --------------------------------- | ----------------------------------------------------------------------------------------- |
| Mode option: individual / company | The two choices on the *I'm registering as* toggle                                        |
| Section heading                   | The "Company information" title above the company fields                                  |
| Field labels                      | Company name, Tax ID / VAT, Address line 1 & 2, City, State / Province, Country, ZIP      |
| Picker placeholders               | "Select a country", "Select a state / province", and the "Search" hint inside the pickers |

Leave any of these blank to use the built-in default.

If your store publishes more than one language, switch the **locale selector** at the top of the editor to translate them — blanks fall back to your primary language, and missing translations are tracked on the **Translations** page.

{% hint style="info" %}
These labels appear only in Company mode. Individual buyers fill in Tax ID and address from your regular field list (own labels above). Customers joining an existing company via an invite link never see this section — their company's details are already on file.
{% endhint %}

***

## Registration page URL

After saving the form, you need to add the **Register Form** block to a page on your store. See [Add the form to your store](/orbit-b2b-docs/b2b-registration/add-to-store.md).

The default path is `/register-form` — you can link to it from your navigation, a button on your homepage, or anywhere else.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://orbit-b2b.gitbook.io/orbit-b2b-docs/b2b-registration/form-builder.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.