One element, two inputs
First name + last name and email address + phone number each produce two fields side by side. In the submission they also appear as two values.
The 23 field types
What a form can ask for at all. The descriptions also appear in the editor when you pick a type.
| Type | What for | Options |
|---|---|---|
| Single-line text (text) | A single-line input for short text. Character limits and an optional default value can be maintained under "Options". | minLength maxLength |
| Multi-line text (textarea) | A multi-line input for longer text. Visible height, character limits and an optional default value can be maintained under "Options". | rows minLength maxLength |
| Dropdown menu (select) | A dropdown with custom options. Options and an optional default selection are maintained under "Options". | option list, default selection |
| Checkbox (checkbox) | A single checkbox for yes/no input. An optional default selection can be maintained under "Options". | defaultChecked |
| Date (date) | A date field based on the browser standard. Optional date range and default value are maintained under "Options". | minDate maxDate |
| Time (time) | A time field based on the browser standard. Optional time range and step size are maintained under "Options". | minTime maxTime step |
| Date + time (datetime-local) | A date and time field based on the browser standard. An optional date-time range is maintained under "Options". | minDateTime maxDateTime |
| Number (number) | A numeric input. Minimum, maximum, step size and an optional default value can be maintained under "Options". | min max step |
| Slider (range) | A slider for numeric values. Minimum, maximum, step size and default value are maintained under "Options". | min max step defaultValue |
| Phone number (tel) | An input for phone numbers. Character limits and an optional default value can be maintained under "Options". | minLength maxLength |
| Color picker (color) | A color picker based on the browser standard. An optional default color is maintained under "Options". | defaultValue |
| URL (url) | An input for URLs. Character limits and an optional default value can be maintained under "Options". | minLength maxLength |
| Email address (email) | An input for one email address. Character limits and an optional default value can be maintained under "Options". | minLength maxLength |
| Single choice (radio) | A single-choice field with multiple visible options. Options and an optional default selection are maintained under "Options". | option list, default selection |
| Multiple choice (checkboxes) | A multiple-choice field with several visible options. Options, default selections and selection limits are maintained under "Options". | option list, default selection minSelections maxSelections |
| Image upload (file) | An upload field for images. Allowed file extensions and maximum file size can be restricted under "Options". | allowedExtensions maxFileSize |
| File upload (file) | An upload field for files. The file is stored in media; allowed extensions and maximum file size can be restricted under "Options". | allowedExtensions maxFileSize |
| Hidden field (hidden) | A hidden field that is not visible in the storefront. The submitted value is maintained under "Options". | value |
| Country selection | A country selection based on the Shopware countries available in the sales channel. | — |
| Consent / agreement | A checkbox for agreements such as privacy, terms or consent. It is named more clearly for this business use case than a regular checkbox. | — |
| Salutation | The Shopware salutation selection as a dropdown. | — |
| First name + Last name | Two Shopware standard fields for first name and last name, displayed side by side. | — |
| Email address + Phone number | Two Shopware standard fields for email address and phone number, displayed side by side. | — |
The "What for" column is the editor's own hint text, word for word. What the options do is on the page about validation.
Single-line text (text)
text
text
Dropdown menu (select)
Choice
select
Date (date)
1 Jul 2026
date
Number (number)
250
number
Single choice (radio)
- A
- B
Multiple choice (checkboxes)
- A
- B
Slider (range)
range
Color picker (color)
#4c3fb5
color
File upload (file)
Filepdf, jpg
file
Consent / agreement
Consent
consent
Country selection
Germany
country
Multi-line text (textarea)
textarea
12 of the 33 types with their control, as the storefront renders it.
Three special cases
Not every type behaves like a single input.
From the master data
Country and salutation take their options from Shopware, not from a list of their own. The country follows the sales channel's countries.
Consent instead of checkbox
Technically a checkbox, named more clearly for the purpose: privacy, terms and consent. As a condition source it knows "is checked" and "is not checked".
Five types cannot trigger a condition: file upload, image upload, hidden field, first name + last name, and email address + phone number. The remaining 18 may be a source.
The eight content elements
They ask for nothing, they simply stand there. Two of them can be shown and hidden with a condition.
| Element | What for |
|---|---|
| Heading | A heading for structuring the form. The visible text is maintained via the label. |
| Vertical line | A separator line for visually structuring the form. No further configuration is required. |
| Line break | A line break for visually structuring the form. No further configuration is required. |
| Free text | A custom text area with HTML support. The visible content is maintained under "Options". |
| Success message (green) | A green success message in Shopware style. The visible text is maintained under "Options". |
| Info message (blue) | A blue info message in Shopware style. The visible text is maintained under "Options". |
| Warning message (yellow) | A yellow warning message in Shopware style. The visible text is maintained under "Options". |
| Error message (red) | A red error message in Shopware style. The visible text is maintained under "Options". |
Going deeper
Layout
Groups, rows and the twelve-column grid.
Fields
All 23 field types and what they do.
Validation
Mandatory fields, limits, CAPTCHA.
Conditions
Twelve operators and the OR rule.