Skip to content

Settings reference

The Settings tab has a side menu: one long Settings page with section anchors, then Notifications, Integrations, Embed, and Preview on pages of their own. Which sections appear depends on the kind of form.

Who can use it

SettingOptionsApplies to
AccessLogged-in users · Only these roles · Anyone, even logged outPost, standalone
RolesWhich roles, when access is by rolePost, standalone
Posts from logged-out visitors belong toA user account that owns what anonymous visitors submitPost

A visitor who cannot submit sees a message with a login link. Word that message under Confirmations.

Registration, login, reset, and product options forms are open to anyone by definition, so they have no access setting.

What it does — create, edit, or both

SettingOptionsApplies to
What it doesCreates a new post · Edits an existing post · BothPost
Which post it editsThe post the page is showing · The post named in the addressPost
Address parameterThe query parameter naming the post. Default editPost
Submit buttonThe button's labelAll
Submit button when editingThe label in edit modePost

An edit-capable form opens prefilled and saves back to the same post, keeping its status.

/submit-listing/?edit=123

Forms saved before the parameter was configurable

Older forms used ?post=123. Those are migrated to edit automatically. If you have links in the wild using ?post=, set the Address parameter back to post.

Who can edit a post

SettingOptions
Editing is open toThe post's author only · Any logged-in user · Only these roles · Whoever WordPress lets edit it
RolesWhich roles, when editing is by role

Administrators and editors can always edit. Everyone else sees "You cannot edit that post."

Roles named here can edit any post the form reaches, not only their own — that is the point of the option, and the reason to reach for it carefully.

New posts

SettingOptions
StatusPending · Published · Draft · Private
AuthorThe submitting user · A fixed user
That userWhich user, when the author is fixed

Pending is the default: a submission waits for review and shows on the dashboard until someone decides it. Editing an existing post always keeps its status.

Terms

SettingWhat it does
New termsAdd terms that do not exist yet when a visitor types a new one

Off by default. Turn it on for tags; leave it off for a controlled taxonomy.

Confirmations

What happens after a submission. The exact options depend on the kind of form.

SettingOptions
Then (post, standalone)Show a message · Go to the new post · Go to a page
Then (registration)Show a message · Go to a page
Then (login)Reload the page · Show a message · Go to a page
Then (reset)Show a message · Go to a login form · Go to a page
MessageThe message shown, when the choice is a message
After changes are savedThe same three choices, for an edit
Message after an editThe message shown after an edit
When the form can't be usedWhat a visitor sees when access says no

Messages accept smart codes, so Thanks, {user_name} works. Redirect addresses accept them too, and are escaped as a URL once they are filled in.

Bots

SettingWhat it does
Bot checkA hidden trap field bots fill in, plus a timing check. Nothing for a real visitor to do
Fastest allowed submissionSeconds from page load. Anything quicker is refused and asked to try again. Default 3
Cloudflare TurnstileAdds a Turnstile check to this form

Turnstile keys are set once for the whole site under VX Modules → Settings → Bot protection, not per form. That screen also spots keys another plugin already has and offers to adopt them, so you do not have to find them again.

Each form then has its own Turnstile switch. The switch cannot be turned on until keys exist.

The trap and the timer are free

The honeypot and the timing check cost nothing and stop most of what hits a small site. Turn Turnstile on when a specific form is actually being abused.

Visitor details

SettingWhat it does
Keep details about each visitBrowser, system, device, screen size, language, time zone, the page the form was on, where the visitor came from, and how long the form took. Shown on the entry
Keep the IP addressOff by default
Anonymize itDrops the last part of the address — 192.168.1.0 instead of 192.168.1.42

IP addresses are personal data

Under EU rules an IP address is personal data. Keep it only if you have a reason to, say so in your privacy policy, and leave Anonymize it on unless the reason needs the full address.

Login and password reset forms never collect visitor details, whatever these settings say.

Uploads

The largest upload a form accepts is set per file field — see Fields and their settings. The site's own upload limit is the ceiling; a field set higher still cannot exceed it.

Embed

ItemWhat it is
Shortcode[vx_form id="your-form-id"], with a copy button
Block, Elementor, BricksAdd VX Form in the block editor, the Elementor widget list, or the Bricks elements, and pick this form

Preview

The form on a bare page in a frame, exactly as a visitor would meet it. It is a real render, not a mock-up, so conditional fields behave and styles apply.

Built by Code Wattz.