Standard Settings

The builder provides these shared settings where applicable. Individual field pages describe additional settings and exceptions. Twig property names and HTML attributes are listed separately below.

Setting	Twig Property / HTML Attribute	Description
Label	field.label	The label for the field. This can be changed per form if you wish.
Handle	field.handle	How the field may be called in templates, if necessary. You may also override this value per form if you wish.
Required	field.required	Toggle if the field requires a value to submit the form successfully.
Custom Validation ErrorNew in 5.7+		Visible when Required is toggled on. If this field is left empty upon submit, show this error message.
Instructions	field.instructions	Specify instructions for the field if you wish.
Default Value	field.defaultValue	For applicable fields, you can set a default value or selected option for the field.
Placeholder	field.placeholder	Specify placeholder text for the field, if applicable.
Browser AutofillNew in 5.17+	field.browserAutofill / autocomplete	Tells browsers what information the field collects so they can offer saved details. Choose a purpose such as Given name, Email address, or Postal code, select On or Off, or leave it at Use browser default.
Maximum Length	field.maxLength / maxlength	The maximum number of characters for the field's value. Applicable to the following Field types Confirm Date & Time Email Hidden Invisible Number Password Phone Regex Text Textarea Website
Attribute Editor		Apply any kind of attribute on the input, label, error, instruction in Freeform's automated rendering of the form.
Options	options field.label value	Specify the option labels and values for applicable field types. Applicable to the following Field types Checkboxes Dropdown Multiple Select Radios

All field types conveniently include the ability to set attributes for their labels, inputs, errors and instructions directly inside the form builder property editor.

• This allows you to keep your hands clean of being inside formatting templates and specify one-off exceptions for fields such as readonly and autocomplete="off", etc.
• To use single attributes like novalidate, just enter the attribute in the Attribute column and leave the Value column empty.
• You can use anything inside the Form and Field objects as well, e.g.:
  • field.id to access Field ID.
  • form.handle to access form handle.