Forms

A form. Build the fields here, set what happens on submit, then place the form on a page with the form embed block.

You will find it in the WordPress admin menu as Forms, stored as canvas_form.

What You Get

These decide where items appear and what you can do with them:

  • One item is called a Form.
  • Items have no page of their own: they are placed inside other pages.
  • Editor features: autosave, editor, title.

Demo

A panel on the Form edit screen, holding these settings:

  • Demo

    Load this demo's stylesheet, fonts and scripts on this content, and add its body class. Leave as None for content that is not part of a demo.

  • Demo Role

    Marks this content as the demo's cart, checkout or other named piece, so the demo can link to it without storing an ID. Free-form; used with the Demo above.

    Shown when Demo is set

Form Settings

A panel on the Form edit screen, holding these settings:

  • Form Type

    Auth form types use WordPress authentication instead of standard actions. Design the form layout in the block editor, then the handler auto-maps fields by name (username, password, email, user_login). A Search Form stores nothing: it submits its fields as query arguments to the results page below.

  • Results Page

    Where the search is sent. The page shows the results; its listing block reads the same field names as query arguments.

    Shown when Form Type is "search".

  • Redirect After Auth

    URL to redirect to after successful login/registration. Leave empty for home page.

    Shown when Form Type is "login" or "register".

  • Auto-login after registration

    Shown when Form Type is "register".

  • Default User Role

    Shown when Form Type is "register".

  • Send Email Notification

  • Save to Database

  • Send Webhook

  • Subscribe to Mailchimp

  • Trigger Side Panel

  • Side Panel ID

    Post ID of the Side Panel to trigger after submission.

    Shown when Trigger Side Panel is "1".

  • Notification Name

  • Send To

    Supports merge tags, e.g. {field:email}. Separate multiple addresses with commas.

  • From Email

  • From Name

  • Reply-To

  • CC

    Comma-separated email addresses.

  • BCC

    Comma-separated email addresses.

  • Subject

  • Message Body

  • Email Format

  • Attach uploaded files to this notification

  • Enable conditional sending

  • Notification Name

  • Send To

    Supports merge tags, e.g. {field:email}. Separate multiple addresses with commas.

  • From Email

  • From Name

  • Reply-To

  • CC

    Comma-separated email addresses.

  • BCC

    Comma-separated email addresses.

  • Subject

  • Message Body

  • Email Format

  • Attach uploaded files to this notification

  • Enable conditional sending

  • Webhook URL

  • Method

  • Request Format

  • Payload Shape

    Third-party form and email services usually expect each field at the top level. The envelope keeps the submission wrapped with its form and request details, which suits your own integrations.

  • Custom Headers

    One header per line, e.g. Authorization: Bearer token123

  • On Success

  • Success Message

    Displayed after a successful submission. HTML allowed.

  • Redirect URL

    Used when "Redirect to URL" is selected above.

  • Clear form fields after successful submission

  • Who Can Submit

  • Allowed Roles

    Only used when "Specific Roles" is selected above.

  • Access Denied Message

  • Submission Limit Per User

    0 = unlimited.

  • Limit Reached Message

  • Enable honeypot field (invisible spam trap)

    On by default for new forms (Theme Options → Forms → Spam).

  • Enable reCAPTCHA v3 (requires keys in Theme Options → Forms → Spam)

  • Enable Cloudflare Turnstile (requires keys in Theme Options → Forms → Spam)

  • Rate Limit (seconds)

    Minimum seconds between submissions from the same IP. 0 = disabled.

  • Submission Retention (months)

    0 = keep forever. Entries older than this will be processed by the retention action below. Leave empty to follow the site default (0 months).

  • Retention Action

    Action to apply to entries older than the retention period.

Other Canvas content types: Copyrights, Events, Footers, Headers, Heroes, Mega Menus.

Was this page helpful?