Configure Regal Forms field settings and conditional logic

Updated September 20, 2026

Regal Forms field settings control how each field looks, what it stores and when it appears. The visual builder keeps field controls beside the canvas and places form-wide configuration in separate header workspaces.

Open Regal Forms field settings#

1. Open Regal Forms > Forms.
2. Select Edit for a form.
3. Select a field in the centre canvas.
4. Use the field settings panel to change its label, description, placeholder, required state, responsive width and CSS classes.
5. Select Save form.

Each canvas component shows its configured placeholder. Choice, hidden and HTML components show an appropriate value or content preview instead.

Add a first and last Name field#

1. Choose Name under Standard fields.
2. Select the Name component in the builder canvas.
3. Set the overall field label, description and required state.
4. Set separate First and Last labels and placeholders.
5. Save the form.

First and Last appear side by side on wider screens and stack on mobile. When required, both parts must be completed. Regal Forms stores the submission as one clean full name. The main Name label preserves its configured casing rather than inheriting an uppercase legend style from the active theme.

Use the form configuration workspaces#

The builder header contains separate buttons for Form settings, Email notifications and Confirmations. Form settings are grouped into clear cards:

• Form details for the name, description and button text.
• Submission behaviour for AJAX submission and CSS classes.
• Spam protection for honeypot, rate limiting and Cloudflare Turnstile.
• Layout for maximum width and field spacing.
• Appearance for theme inheritance or custom styling.

What honeypot protection does#

Honeypot protection adds a field that genuine visitors cannot see. It remains invisible and occupies no form space on published pages and compatible live previews. Basic automated bots often complete every field, so Regal Forms rejects a submission when the hidden field contains a value. It adds no visible challenge, but it should be used with the submission limit and, where stronger protection is needed, Cloudflare Turnstile. The Turnstile widget follows the form field-spacing setting, keeping it visually separated from the final field on desktop and mobile.

Insert smart tags into notifications#

Each notification address, name, subject and message control includes an Insert smart tag list. It contains fields from the current form together with site, form, entry and logged-in user tags. Stable field tags continue to work if their visible labels change later.

When {all_fields} is used in an HTML email notification, every non-empty submitted field appears on its own line with the field name in bold. Uploaded File fields show their stored upload URL as a clickable link. Plain-text notifications use one Field name: value line per field.

Configure dropdown, radio and checkbox choices#

Dropdown, radio and checkbox fields use a focused choice editor. Each row has one Choice label, which is the text visitors see.

1. Use Add choice to create another option.
2. Edit the choice label shown to visitors.
3. Use the arrow buttons to arrange choices in the required order.
4. Use the remove button to delete a choice.

Regal Forms creates and keeps a stable internal value automatically. You do not need to set it manually. This means a choice can be renamed or moved without changing existing entry data or breaking conditional logic.

Choose theme or custom form styling#

Open Form settings, then use Inherit styling from the active theme under Appearance. When enabled, the active WordPress theme controls labels, input fields and the submit button. Regal Forms exposes standard classic and block-theme button classes so supported theme button colours, text colours and hover styles apply. When theme inheritance is disabled, the saved Button colour remains the same while a submission is processing, as well as during hover. Regal Forms continues to control maximum width, spacing, responsive columns, validation and loading behaviour.

Set exact custom colours#

When theme inheritance is disabled, each colour setting provides a visual swatch and an exact six-digit hex input. Enter a value such as #A43129. The swatch and text value remain synchronised, and the saved form uses that exact colour.

Understand required-field errors#

When a required field is empty, the error identifies the field by name, for example Email address is required. Regal Forms highlights the complete field group in red, marks the affected input as invalid for assistive technology and moves keyboard focus to the first invalid field.

Create grouped conditional logic#

1. Enable conditional logic for a field, notification or confirmation.
2. Select whether every group or any group must match.
3. Add a rule group and choose whether all rules or any rule within that group must match.
4. Choose the source field, operator and expected choice.

Regal Forms repeats conditional decisions during submission processing. Browser-side visibility is not treated as a security boundary.

Troubleshoot Regal Forms field settings#

• If a field tag is missing from a notification, confirm the field has been added to the current form.
• If a condition never matches, save the form after changing its choices so the automatic internal values are retained.
• If a colour does not save, enter the full hash followed by six hexadecimal characters.
• If spam continues, keep the honeypot enabled and configure Cloudflare Turnstile under Regal Forms > Settings.

For general guidance on accessible form labels and errors, see the W3C forms tutorial.

Use Google reCAPTCHA or Cloudflare Turnstile#

Open Regal Forms > Settings and add the site and secret keys for the service you want to use. The secret keys remain protected WordPress options and are not shown in the builder or sent to visitors.

1. Open the form and select Form settings.
2. Under Spam protection, enable Cloudflare Turnstile or Google reCAPTCHA.
3. For Google reCAPTCHA, choose v2 checkbox when visitors should complete a visible challenge, or v3 score for an invisible score-based check.
4. Save the form and test a genuine submission.

Google issues different site keys for v2 and v3, so use keys registered for the selected mode and the site domain. See the Google reCAPTCHA version guide for key registration details.

Show a form-level error summary#

Under Form settings > Submission behaviour, enable Show an error summary. When validation fails, Regal Forms shows a linked list of invalid fields above the form as well as the existing inline messages. Each link moves focus to the relevant field, improving keyboard and screen-reader navigation.

Receive private Regal Forms updates#

Regal Forms now uses the configured Regal IT Licence Server through WordPress’s normal plugin update screen. When a newer eligible package is published for Regal Forms, WordPress can show the update and download the package through the server’s authorised package URL. Keep a valid licence active when the published package requires a licence for updates.