Luxa Forms — User Guide

After activating Luxa Forms, you’ll find a new Luxa Forms menu item in your WordPress admin sidebar. It contains:

• Dashboard — an overview of your forms and recent entries
• Forms — the list of every form you’ve created, with a link into the Builder for each
• Entries — every submission across all your forms, filterable by form
• Add-ons — browse and license official add-ons (shown once Luxa Forms Pro is active)
• Settings — global plugin settings (notification defaults, spam protection thresholds, etc.)

To create your first form, go to Luxa Forms → Forms → Add New.

The Form Builder has three columns:

• Left: Field Palette — every available field type, grouped into Basic, Choice, Advanced, and Layout
• Center: Canvas — your form as it’s being built, top to bottom
• Right: Settings Panel — settings for whichever field is currently selected

To add a field: click any button in the left palette. It’s added to the end of your form and automatically selected, so its settings appear on the right immediately.

To reorder fields: click and drag a field card in the canvas by its drag handle, and drop it in a new position. This works in both the free version and Pro.

To edit a field: click its card in the canvas — the Settings Panel on the right updates to show that field’s options. Changes save automatically as you type (look for the “Saved” indicator near the top of the builder).

To delete a field: select it, then use the delete (trash) icon on its card.

When you’re happy with your form, it’s already saved — there’s no separate “Publish” step for the form itself. You publish it to a page using the shortcode or block (see Section 5).

Basic

Choice

Advanced

Layout (no submitted value)

Every input field shares a common set of settings in the right-hand panel:

• Label — the question or field name shown to visitors
• Placeholder — faint example text shown inside an empty field
• Description — optional helper text shown below the field
• Required — toggle whether a visitor must fill this in before submitting
• Width — Full, Half, or Third — lets you place fields side by side

Choice fields (Select, Radio, Checkboxes) additionally have an Options list where you add/remove/reorder the available choices.

Shortcode (all versions)

Every form has a shortcode shown at the top of its Builder page, in the form:

[luxa_form id="1"]

Paste this into any post, page, or widget area that accepts shortcodes.

Gutenberg Block (requires the Gutenberg Block add-on)

See Section 13.

Go to Luxa Forms → Entries to see every submission. Use the form filter dropdown at the top to narrow the list to one specific form. Click any entry to see the full set of answers submitted.

Entries are stored permanently in your own WordPress database — there’s no external service involved and no entry limit.

Under a form’s Settings tab (inside the Builder), configure:

• Send To — the email address(es) that should receive a notification
• Subject — the notification email’s subject line
• Message — the email body. Use merge tags like {field_key} to automatically insert whatever a visitor typed into a specific field — the exact tag for each field is shown next to it in the field list on this tab

Notifications are sent immediately after a successful submission, using WordPress’s own mail system (wp_mail()). If you want your emails to be delivered safely to the inbox, make sure to use the Luxa SMTP plugin.

Every Luxa Forms form ships with spam protection already turned on — there’s nothing to configure for basic protection:

• Honeypot — an invisible field real visitors never see or fill in; bots that auto-fill every field on a page get caught here
• Nonce verification — every submission is checked against a form-specific security token
• Rate limiting — an IP address submitting the same form too many times in a short window is automatically throttled

If you’re still seeing spam get through, check Luxa Forms → Settings → Spam Protection for rate-limit threshold adjustments.

With Luxa Forms Pro active, you get a second way to add fields: click and hold any button in the left palette, then drag it directly into the canvas and drop it exactly where you want it — between two existing fields, at the top, anywhere. Clicking still works exactly as before; this is purely an additional option, not a replacement.

This can be turned off (falling back to click-only) under Luxa Forms → Modules, if you prefer the simpler click-to-add flow for your team.

Once Luxa Forms Pro is licensed, a new Add-ons menu item appears. Each official add-on shows as a card with its current status:

• Available — not yet licensed; click Unlock and enter your add-on’s license key
• License Verified — licensed but not installed yet; click Install Now
• Installed — installed but not activated; click Activate
• Active — installed, licensed, and running
• Update available — a new version is ready; click Update

Every action (unlock, install, activate, deactivate, uninstall, update) happens right on this screen — no manual file uploads, no visiting a separate download page.

Conditional Logic lets a field’s visibility depend on what a visitor has already entered elsewhere in the form.

To set up a rule:

1. Select the field you want to conditionally show or hide
2. Open the Conditional Logic tab in its Settings Panel
3. Choose Show this field if… or Hide this field if…
4. Pick the field to check, the comparison (Equals, Not Equals, Contains, Greater Than, Less Than, Is Empty, Is Not Empty), and the value to compare against
5. Add more rules and combine them with AND (all must match) or OR (any must match)

Hiding a whole section: target a Heading field with your rule — every field between that heading and the next one inherits its hidden/visible state automatically, so you don’t need a rule on each individual field.

Rules apply instantly as visitors fill out the form, and are always re-checked on the server when the form is submitted — a required field that’s currently hidden can never block submission, and a hidden field’s value is never processed even if something tampers with the page.

Multi-step Form splits a long form into a guided, page-by-page experience.

To add a step break:

1. In the Builder, add a Page Break field (found in the Layout group) at the point where you want a new step to begin
2. Select it and set an optional Step Title (shown in the progress bar), plus optional custom Next and Back button text
3. Add as many Page Break fields as you need — each one starts a new step

Visitors see a progress bar at the top of the form and Next/Back buttons instead of a single long scroll. Each step’s required fields must be filled in before the visitor can continue to the next one. The form still submits as a single entry at the end — nothing changes about how entries or notifications work.

Once active, open the block editor on any post or page, search for “Luxa Form,” and insert it. Use the block’s own settings panel (on the right, when the block is selected) to pick which form to display from a dropdown — no shortcode or form ID to remember. The block renders the form live right there in the editor, exactly as it will appear on the published page.