Form

A working form. Place Form Field and Form Submit blocks inside: submissions are validated, saved and emailed. It is shown in the block inserter as Form and registered as canvas-core/form-container.

Select the block on a page and its own settings open in the sidebar, in the panels below:

The Form settings in the block editor sidebar

Settings

Each setting is named exactly as the block editor names it, followed by what it does and what it starts as. Where a setting carries a Shown when line, it stays hidden until that condition is met, which is the usual reason a setting looks missing from the sidebar:

Form

  • Form KeyDefaultEmpty

    Identifies this form on the page when it is submitted. Leave empty to derive one automatically; set it when a page has several forms so entries stay distinguishable.

  • Field LayoutDefaultStacked (one field per line)

    Grid row adds the .row class to the form so the per-field Width setting (½, ⅓, …) takes effect.

    ChoicesStacked (one field per line)Grid row (honours field widths)

  • Form Element Extra ClassesDefaultEmpty

    Style classes on the form element itself. The classes field in the Advanced panel styles the block around it instead.

  • Form Element IDDefaultEmpty

    Optional id attribute for the form element itself. Empty = the default generated id.

  • Form Element Inline CSSDefaultEmpty

    Styling written straight onto the form element, such as a maximum width to stop a short form running the whole width of the page.

Submission

  • Save EntriesDefaultOn

    Store each submission in the Canvas form entries table.

  • Send Email NotificationDefaultOn

    Sends you a message whenever the form is submitted. Turn it off for a form whose entries you would rather read in the admin only.

  • Notification RecipientDefaultEmpty

    Comma-separated addresses. Empty uses the site admin address.

    Shown when Send Email Notification is on

  • Notification SubjectDefaultEmpty

    The subject line of that message. Leave it empty and Canvas writes one from the site name and the form.

    Shown when Send Email Notification is on

  • On SuccessDefaultShow a message

    What happens once the form has been sent: a thank you in place of the form, or a move to another page such as a dedicated thank you page.

    ChoicesShow a messageRedirect

  • Success MessageDefaultEmpty

    What the visitor is told once the form has been sent. Say what happens next, such as when you will reply.

    Shown when On Success is "Show a message"

  • Redirect URLDefaultEmpty

    The page the visitor is taken to once the form has been sent.

    Shown when On Success is "Redirect"

  • Clear Fields After SubmitDefaultOn

    Empties the fields once the form has been sent, so a second entry starts fresh rather than repeating the first.

Access

  • Who Can SubmitDefaultEveryone

    Whether anyone can send the form, or only visitors signed in to your site.

    ChoicesEveryoneLogged-in users only

  • Access Denied MessageDefaultEmpty

    Shown in place of the form to a visitor who is not signed in. Tell them where to sign in, or the form is a dead end.

    Shown when Who Can Submit is "Logged-in users only"

  • Honeypot Spam TrapDefaultOn

    Adds a hidden field bots fill in and humans never see.

  • Rate Limit (seconds)Default0

    Minimum seconds between submissions from one IP. 0 disables it.

Style tab

  • Accent Color

    A style control in the Form group of the Style tab.

  • Field Spacing

    A style control in the Form group of the Style tab.

  • Field Radius

    A style control in the Form group of the Style tab.

Every Canvas block also carries the Animation, Scroll Effects and Advanced panels, which are described in Controls every Canvas block has.

Other blocks in Forms: Form Embed, Form Field, Form Submit Button, Quick Contact.

Was this page helpful?