All field types
All 33 element types with options and attributes.
All element types
Thirty-three types in three kinds. The "entries" column names what the editor offers on the element, the "options" column what is added under "Options".
Input elements 23
Only these are validated and stored.
| Type | What for | Entries | Options |
|---|---|---|---|
| Single-line text (text) text |
A single-line input for short text. Character limits and an optional default value can be maintained under "Options". | Label, Mandatory, Placeholder, Default value | minLength maxLength |
| Multi-line text (textarea) textarea |
A multi-line input for longer text. Visible height, character limits and an optional default value can be maintained under "Options". | Label, Mandatory, Placeholder, Default value | rows minLength maxLength |
| Dropdown menu (select) select |
A dropdown with custom options. Options and an optional default selection are maintained under "Options". | Label, Mandatory, Placeholder, Option list | — |
| Checkbox (checkbox) checkbox |
A single checkbox for yes/no input. An optional default selection can be maintained under "Options". | Label, Mandatory | defaultChecked |
| Date (date) date |
A date field based on the browser standard. Optional date range and default value are maintained under "Options". | Label, Mandatory, Placeholder, Default value | minDate maxDate |
| Time (time) time |
A time field based on the browser standard. Optional time range and step size are maintained under "Options". | Label, Mandatory, Placeholder, Default value | minTime maxTime step |
| Date + time (datetime-local) datetime-local |
A date and time field based on the browser standard. An optional date-time range is maintained under "Options". | Label, Mandatory, Placeholder, Default value | minDateTime maxDateTime |
| Number (number) number |
A numeric input. Minimum, maximum, step size and an optional default value can be maintained under "Options". | Label, Mandatory, Placeholder, Default value | min max step |
| Slider (range) range |
A slider for numeric values. Minimum, maximum, step size and default value are maintained under "Options". | Label, Mandatory, Default value | min max step defaultValue |
| Phone number (tel) phone |
An input for phone numbers. Character limits and an optional default value can be maintained under "Options". | Label, Mandatory, Placeholder, Default value | minLength maxLength |
| Color picker (color) color |
A color picker based on the browser standard. An optional default color is maintained under "Options". | Label, Mandatory, Default value | defaultValue |
| URL (url) url |
An input for URLs. Character limits and an optional default value can be maintained under "Options". | Label, Mandatory, Placeholder, Default value | minLength maxLength |
| Email address (email) |
An input for one email address. Character limits and an optional default value can be maintained under "Options". | Label, Mandatory, Placeholder, Default value | minLength maxLength |
| Single choice (radio) radio |
A single-choice field with multiple visible options. Options and an optional default selection are maintained under "Options". | Label, Mandatory, Option list | — |
| Multiple choice (checkboxes) checkbox-group |
A multiple-choice field with several visible options. Options, default selections and selection limits are maintained under "Options". | Label, Mandatory, Option list | minSelections maxSelections |
| Image upload (file) image |
An upload field for images. Allowed file extensions and maximum file size can be restricted under "Options". | Label, Mandatory | allowedExtensions maxFileSize |
| File upload (file) file |
An upload field for files. The file is stored in media; allowed extensions and maximum file size can be restricted under "Options". | Label, Mandatory | allowedExtensions maxFileSize |
| Hidden field (hidden) hidden |
A hidden field that is not visible in the storefront. The submitted value is maintained under "Options". | Label | value |
| Country selection country |
A country selection based on the Shopware countries available in the sales channel. | Label, Mandatory, Placeholder | — |
| Consent / agreement consent |
A checkbox for agreements such as privacy, terms or consent. It is named more clearly for this business use case than a regular checkbox. | Label, Mandatory | — |
| Salutation salutation |
The Shopware salutation selection as a dropdown. | — | — |
| First name + Last name firstname-lastname |
Two Shopware standard fields for first name and last name, displayed side by side. | Mandatory | — |
| Email address + Phone number email-phone |
Two Shopware standard fields for email address and phone number, displayed side by side. | Mandatory | — |
Content elements 8
They output and ask for nothing.
| Type | What for | Entries | Options |
|---|---|---|---|
| Heading title |
A heading for structuring the form. The visible text is maintained via the label. | Label | — |
| Vertical line separator |
A separator line for visually structuring the form. No further configuration is required. | — | — |
| Line break line-break |
A line break for visually structuring the form. No further configuration is required. | — | — |
| Free text content |
A custom text area with HTML support. The visible content is maintained under "Options". | Content | — |
| Success message (green) alert-success |
A green success message in Shopware style. The visible text is maintained under "Options". | Content | — |
| Info message (blue) alert-info |
A blue info message in Shopware style. The visible text is maintained under "Options". | Content | — |
| Warning message (yellow) alert-warning |
A yellow warning message in Shopware style. The visible text is maintained under "Options". | Content | — |
| Error message (red) alert-danger |
A red error message in Shopware style. The visible text is maintained under "Options". | Content | — |
Structure elements 2
They arrange, they take nothing.
| Type | What for | Entries | Options |
|---|---|---|---|
| Group group |
A section for related form areas. Groups structure larger forms and can contain rows and fields. | Label | — |
| Row row |
A layout row. Fields inside the row can be displayed next to each other with widths like 1/2, 1/3 or 1/4. | — | — |
What becomes of the options
Read in the source of the storefront templates.
| Option | In the form | Who validates |
|---|---|---|
minLength / maxLength | minlength maxlength | Browser and server |
min / max / step | min max step | Browser and server |
rows | rows | display only |
minDate / maxDate | min max | Browser and server |
minTime / maxTime | min max | Browser and server |
minDateTime / maxDateTime | min max | Browser and server |
allowedExtensions | accept | Browser and server |
maxFileSize | data-max-file-size | the server only |
minSelections / maxSelections | — | the server only |
defaultValue / defaultChecked | value or checked | no validation, only a preset |
value | value on the hidden field | the server only |
Uploads in detail
Three limits lie on top of one another, and the outermost is not the plugin's.
- 01 The shop Outermost sits Shopware's own list of allowed file extensions. What is missing there gets through nowhere.
- 02 The field The option on the field narrows it further. Without an entry a long default list applies, not "anything".
- 03 On the image upload Additionally only jpg, jpeg, png, gif, webp and avif - and the file has to really be an image, not just be named like one.
- 04 The size The upper limit is in megabytes and is checked on the server. In the form it is only a data attribute - the browser does not enforce it by itself.
The uploaded file then sits in the media manager, in the folder named in the configuration. The submission holds the reference to it, not the file.
The chapters
Conditions
The 12 operators and what they compare.
Placement
Output points, assignments, order of precedence.
Settings
The seven settings with their defaults.
Glossary
What the words mean.