There are no required options for forms. However as outlined in the Frontend Forms overview, it is highly recommend to at least have a form name:
form: name: my-form
This must be unique for your Grav site. This is because the form's name serves as a unique identifier for this form through the system. A form can be referenced by this name from any other page.
This option allows you to control if the form should be submitted via
GET. The default is
POST. Also note, if you have a
file field in your form, the method will also get
form: method: GET
The action by default is going to be the route as the current page. This makes sense most of the time because the form needs to be processed by the the same page that houses the form. There are times when you want to override the action however to either specify a different file extension (
.json perhaps) or even target a specific page anchor:
form: action: /contact-us#contact-form
You can even process the form on another page if that page is where you want to handle the results. This can also be used as a technique to alter the template of the response from the one used in the original form:
form: action: /contact-us/ajax-process
Where you have a page file called
form-messages.html.twig that returns just the message data. Alternatively you can use the approach below...
form: template: form-messages
The ability to set a form-level CSS
id field. If not provided the form's name is used.
form: id: my-form-id
You can also set explicit classes on the form. There are no default values here.
form: classes: 'form-style form-surround'