For the complete documentation index, see llms.txt. This page is also available as Markdown.

Building with forms

Create a form, configure its fields and settings, then place it in your theme.

Use Forms when you need to collect structured data from shoppers.

Common uses are contact forms, trade applications, quote requests, and onboarding flows.

What you manage in Forms

The main Forms screen shows:

  • each form name

  • submission counts

  • Settings

  • Mail Templates

  • View Submissions

Use this screen to manage the whole lifecycle of a form.

Build your first form

1

Open Forms and create a new form

Click Create Form from the main Forms screen.

2

Add the form name

Use a clear internal name that your team will recognise later.

3

Review the handle

The handle is used when you place the form in the theme.

Keep it stable after launch.

4

Turn on only the advanced settings you need

Review the optional features before you build the field list.

5

Build the form fields

Add the inputs, choose widths, and mark required fields.

6

Configure email recipients and templates

Set up both customer and admin emails if the form should notify people automatically.

7

Add the form to your theme

Place the form block in the theme editor and enter the form handle.

8

Submit a real test

Check the storefront form, the emails, and the saved submission.

Advanced settings explained

Inside Advance Settings, you can enable:

  • Save details into a customer profile

  • Save submissions to customer metafield

  • Enable reCAPTCHA spam protection

  • Link form to product purchase

  • Enable Google Sheets Integration

  • Trigger Klaviyo event on form submission

Turn on only the features your workflow needs.

Build the field list well

Each form field lets you control:

  • field type

  • field width

  • label or heading

  • field name

  • whether the field is required

  • whether the response should be saved as a customer tag

You can also drag fields to reorder them.

Setup rules that prevent rework

  • Use a stable handle after the form is live.

  • Use clear field names such as email, phone, or companyName.

  • Make the email field required if customer emails depend on it.

  • Use half-width only when two fields naturally belong together.

  • Test every enabled automation with a fresh submission.

Test before launch

Run these checks:

  1. the form loads in the right theme location

  2. required fields block incomplete submissions

  3. emails send to the right people

  4. advanced settings save the data where expected

  5. mobile spacing and field height feel correct

Last updated