---
title: "How to create a form?"
description: "Add a Form step to a QR code's workflow so visitors leave their details between the scan and your page. Pick a form type, manage the fields, set the skip options, and find every answer in Visitors."
canonical: "https://linkbreakers.com/help/article/how-to-create-a-form"
last-updated: 2026-10-28
---

# How to create a form?

> Add a Form step to a QR code's workflow so visitors leave their details between the scan and your page. Pick a form type, manage the fields, set the skip options, and find every answer in Visitors.

## Short answer

To create a form in Linkbreakers, open a link's workflow, hover the connector between the scan and the page, click the plus and choose **Form**. Pick a form type (Rating Form, Contact Form, Inquiry Form or Blank Form), adjust the fields with **Manage Fields**, then click **Insert Form Step**. From then on, every scan of that QR code shows the form before the visitor continues, and each submission is saved on the visitor, in **Visitors**.

If your goal is collecting leads from a printed code, [How to add a lead capture form to a QR code](https://linkbreakers.com/help/article/how-to-add-a-lead-capture-form-to-a-qr-code) walks through the whole setup, from the booth sign to the exported list.

## Quick summary

- A form is a workflow step: it sits between the scan and the next step, usually the redirect to your page
- Four starting points: Rating Form, Contact Form (first name, last name, email), Inquiry Form (email and a message) and Blank Form
- 10 field types: Text, Email, Phone, Text Area, Number, Date, Radio, Checkbox, Dropdown and Rating
- **Automatically skip if data is known** spares returning visitors; **Allow visitors to skip this form** makes it optional
- Fields with the reserved keys `$firstName`, `$lastName`, `$email` and `$phone` fill the visitor's profile; other keys are saved as custom attributes
- Submissions show in Live Events as they arrive and on each visitor in Visitors

:::try-ai-prompt {"prompt":"Add a form that collects email, first name, last name, and company name before the redirect.","description":"See how the AI workflow builder adds a lead capture form to your workflow in seconds."}:::

## Why use form steps?

A [form step](/workflow-steps/form) turns a QR code from a plain redirect into a short exchange: the visitor scans, answers, and then continues. You can use it to:

- Collect contact details before the visitor reaches your page, as lead capture
- Gather feedback or a rating at the point of experience
- Qualify visitors with one question, such as when they plan to buy
- Build visitor profiles over several scans, since known data can skip the form
- Route visitors differently afterwards with a [visitor data condition](https://linkbreakers.com/help/article/how-to-use-visitor-data-conditions), for example to show [a second form only to the people who answered yes](https://linkbreakers.com/help/article/how-to-build-a-customer-journey-with-forms)

## Creating your first form step

Video: [How to add a lead capture form to a QR code](https://www.youtube.com/watch?v=MV8T--GPCwk)

### Step 1: Open the link's workflow

1. Log in to your [Linkbreakers dashboard](https://app.linkbreakers.com/)
1. Go to [Links](https://app.linkbreakers.com/workspace/dashboard/links) and click **Add new link**, or open an existing link
1. The workflow canvas shows the scan (Link Visit) connected to the redirect to your page

### Step 2: Insert the form

1. Hover the connector between the two steps and click the plus
1. Choose **Form**
1. Choose a form type:

| Form type | Fields it starts with |
|-----------|-----------------------|
| **Rating Form** | A rating field, a comment area and optional email collection |
| **Contact Form** | First name, last name and email |
| **Inquiry Form** | Email and a message |
| **Blank Form** | No fields: build your own |

### Step 3: Manage the fields

Click **Manage Fields**, then **Add Field** to add a field, or remove the ones you do not need. There are 10 field types:

| Field Type | Description | Best For |
|------------|-------------|----------|
| **Text** | Single-line text input | Names, titles, short answers |
| **Email** | Email input with format validation | Lead capture, newsletter signups |
| **Phone** | Phone number input | Sales leads, call-backs |
| **Text Area** | Multi-line text input | Feedback, comments, detailed responses |
| **Radio** | Single selection from visible options | Yes/no questions, small option sets (2-4 choices) |
| **Checkbox** | Multiple selection from options | Preferences, consent, multi-select surveys |
| **Dropdown** | Single selection from a list | Larger option sets, qualifying questions |
| **Number** | Numeric input only | Quantities, ages, budget ranges |
| **Date** | Date picker | Appointments, birthdays, event registration |
| **Rating** | Rating scale | NPS surveys, satisfaction scores |

The Rating field shows a 0 to 10 scale. To route people by the score they give, see [how to route visitors based on NPS scores](https://linkbreakers.com/help/article/how-to-route-visitors-based-on-nps-scores).

For each field, you set:

- **Label**: what visitors see above the field
- **Key**: the name the answer is saved under. A key is suggested from the label
- **Placeholder**: helper text inside the empty field
- **Options**: the choices, for Radio, Checkbox and Dropdown fields
- **Required field**: whether the field must be completed

Click **Done** when the fields are ready.

#### Reserved keys

Keys that start with `$` are reserved. Four are supported, and they fill the visitor's profile:

| System Key | Description |
|------------|-------------|
| `$email` | Email address |
| `$phone` | Phone number |
| `$firstName` | First name |
| `$lastName` | Last name |

Any other key (for example `timeline` for "When do you plan to buy?") is saved on the visitor as a custom attribute, shown under **Custom Attributes** on the visitor's page.

### Step 4: Set the form's behaviour, then insert it

- **Form Title**, **Form Description** and **Submit Button Text** (all optional): what visitors read and tap
- **Allow visitors to skip this form**: adds a skip button so the form becomes optional, with its own button text
- **Automatically skip if data is known**: on by default. If the visitor already has the required data on file, the step is skipped, so someone who already left their details is not asked again

Click **Insert Form Step**. The form now sits between the scan and your page.

## Building multi-step form workflows

### Creating sequential forms

You can chain multiple form steps together to reduce visitor overwhelm:

1. **Step 1**: Basic contact information (name, email)
1. **Step 2**: Company details (organization, role)
1. **Step 3**: Preferences and interests
1. **Step 4**: Thank you message or content delivery

### Connecting form steps

1. Insert your first form step
1. Hover the connector after it and click the plus
1. Choose "Form" for the next step
1. Configure the second form with additional fields
1. Repeat as needed for your workflow

> **Pro tip**: Keep each form step to three to five fields to maintain high completion rates.

## Best practices for form design

### Field selection guidelines

**Essential fields only**: Only mark fields as required if you absolutely need that information. Each required field reduces completion rates.

**Logical progression**: Order fields from general to specific:

1. Name fields first
1. Contact information second
1. Preferences and details last

**Smart field types**: Choose field types that match your data:

- Use the Email type for email addresses (built-in format validation)
- Use the Phone type for phone numbers
- Use Dropdown instead of Radio for five or more options

### Form copy and messaging

**Clear value proposition**: Explain why you're collecting information:

- "Get exclusive updates about new products"
- "Customize your experience based on your interests"
- "Receive your personalized recommendations"

**Helpful labels and placeholders**:

- Label: "Email Address"
- Placeholder: "Enter your email address"
- Form Description: "We'll never share your email with third parties"

### Mobile optimization

All Linkbreakers forms are mobile-responsive by default, but consider:

- Short labels that fit on small screens
- Minimal required fields for thumb-friendly completion
- Short option lists in Dropdown fields

## Advanced form features

### System field integration

When you use system fields (`$email`, `$phone`, etc.), the data automatically updates visitor profiles. This enables:

- Visitor recognition across multiple QR codes
- Progressive profiling over time, since **Automatically skip if data is known** skips a form whose required data is already on file
- Filtering in Visitors by name or email, and by any custom attribute with **Filter by attribute**
- Routing with a [visitor data condition](https://linkbreakers.com/help/article/how-to-use-visitor-data-conditions)

### Validation and data quality

Linkbreakers automatically validates:

- Email formats for Email fields
- Required field completion
- Option selection for Radio, Checkbox and Dropdown fields

### Skip functionality

Enable form skipping when:

- Information is helpful but not essential
- You want to accommodate privacy-conscious visitors
- Testing shows high abandonment rates

## Measuring form performance

### Where to see results

- **Live Events**: each scan appears as it happens, and the row fills in with the visitor's email once the form is submitted. Open a row to see the "Form Submitted" event with every answer
- **Visitors**: everyone who submitted, with name, email, the answers under **Custom Attributes** and the links they visited
- **Step funnel**: how many visits reached each step of the workflow and how many went on, so you can see how many people who arrived submitted the form. Ask the [Assistant](https://linkbreakers.com/help/article/the-assistant-section) or call `POST /v1/analytics/funnel` in the API

Linkbreakers does not report field-level abandonment or time to complete.

### Optimization strategies

**A/B testing**: Put two versions on two links and compare their step funnels. Elements worth testing:

- Form titles and descriptions
- Required vs. optional fields
- Field order and types
- Submit button text

**Iterative improvement**:

- Start with essential fields only
- Add fields gradually based on completion rates
- Remove fields that cause high abandonment

## Common use cases

### Lead generation

**Scenario**: Collecting qualified leads at trade shows

**Form strategy**: Start with email capture, then add company details for qualified prospects. The full setup, with one link per placement and the list of leads in Visitors, is in [How to add a lead capture form to a QR code](https://linkbreakers.com/help/article/how-to-add-a-lead-capture-form-to-a-qr-code)

Example workflow:

- Step 1: Email capture with a compelling offer
- Step 2: Name and company (if qualified)
- Step 3: Redirect to exclusive content

### Event registration

**Scenario**: Managing event attendees and preferences

**Form strategy**: Multi-step forms with contact info, dietary requirements, and session preferences

Example workflow:

- Step 1: Name and email
- Step 2: Dietary restrictions and accessibility needs
- Step 3: Session preferences
- Step 4: Confirmation page with event details

### Customer feedback

**Scenario**: Gathering product feedback and satisfaction data

**Form strategy**: Mix rating fields, multiple choice, and open-ended text areas

Example fields:

- Rating: "How satisfied are you with our product?"
- Multiple choice: "Which features do you use most?"
- Text area: "What improvements would you suggest?"

### Content gating

**Scenario**: Providing valuable content in exchange for contact information

**Form strategy**: Minimal friction with just email and name, plus a clear value proposition

Example messaging:

- "Get Your Free E-book"
- Enter your email to receive our comprehensive guide on [topic].
- Email field
- Submit button: "Send Me the Guide"

## Troubleshooting common issues

### Low completion rates

**Solutions**:

- Reduce required fields to absolute essentials
- Add clear value proposition messaging
- Test mobile experience thoroughly
- Consider adding the form skip option

### Data quality issues

**Solutions**:

- Use appropriate field types (Email, Phone, Number)
- Include helpful placeholder text
- Provide clear error messages

### Technical problems

**Solutions**:

- Ensure all required fields have appropriate validation
- Test form submission on multiple devices
- Verify system field mapping is working correctly
- Check workflow connections between steps

## Frequently asked questions

### How many fields should I include in my form?

Keep forms to three to five fields per step for optimal completion rates. If you need more information, use multi-step forms to break up the data collection process.

### Can visitors skip my form?

Yes. Tick **Allow visitors to skip this form** in the form's settings, and a skip button appears under the form. This is useful when information is helpful but not essential, or when you want to accommodate privacy-conscious visitors.

### What's the difference between system fields and regular fields?

System fields (`$email`, `$phone`, `$firstName`, `$lastName`) fill the visitor's profile: the name, email and phone shown in Visitors and included in its CSV export. Fields with any other key are saved on the visitor as custom attributes, shown under **Custom Attributes** and usable in **Filter by attribute** and in [visitor data conditions](/workflow-steps/visitor-data-condition).

### How do I create a multi-step form?

Insert your first form step, then click the plus on the connector after it, choose **Form** again, and configure the next one. You can chain as many form steps as needed.

### Are forms mobile-friendly?

Yes. Linkbreakers forms are responsive by default and adapt to the screen they open on, which is usually the phone that scanned the code.

### Can I use conditional logic in my forms?

Individual form fields don't have conditional display logic. After the form, a [visitor data condition](https://linkbreakers.com/help/article/how-to-use-visitor-data-conditions) can send visitors down different paths based on what they answered.

### How do I track form performance?

Submissions appear in Live Events as they arrive and in Visitors. To see how many people who arrived submitted the form, use the step funnel, through the Assistant or `POST /v1/analytics/funnel`. Field-level abandonment and time to complete are not reported.

### What happens to the data visitors submit?

Each submission is saved on the visitor: system fields fill the profile, other answers become custom attributes, and the "Form Submitted" event keeps every answer in the event timeline. **Export CSV** in Visitors downloads the list with names and emails. When we tested it in October 2026, the custom answers came out empty in the export, so read those on each visitor's page or receive them by webhook.

### Can I integrate form data with other tools?

Yes. A [webhook](https://linkbreakers.com/help/article/how-do-webhooks-work-in-linkbreakers) sends each form submission, with its answers, to your endpoint as it happens, and can be limited to one link. Zapier, Make and n8n can pass it on to a CRM.

### What's the best way to increase form completion rates?

Start with minimal required fields, explain what the visitor gets, keep labels short for phones, and consider enabling the skip option. Test one change at a time on two links and compare their step funnels.

## Conclusion

Good forms balance data collection with the visitor's time. Start with the fewest fields you need, check how many people submit, and adjust. To follow the form with a thank-you screen, add a [message page](https://linkbreakers.com/help/article/how-to-create-a-message-page) after it.

## Limits and caveats

- Forms and Visitors are on every plan, including Free ([pricing](https://linkbreakers.com/pricing)).
- Fields have no conditional display logic; branch after the form with a condition step instead.
- Only four reserved keys fill the profile: `$firstName`, `$lastName`, `$email` and `$phone`. Everything else is a custom attribute.
- With **Automatically skip if data is known** on (the default), a visitor whose required data is already on file does not see the form again. Turn it off if every scan must show the form.
- Collecting personal data has legal obligations that depend on where you and your visitors are. Say why you collect it and link your privacy policy in the form description.
