Resolve common POM Forms problems

Use this page when the symptom is already known. For an unexplained failure, begin with the outside-in diagnostic sequence. Test while signed out in a private browser window because administrator state and autofill can hide the visitor experience.

The Forms menu is missing

An administrator must enable Settings → POM Theme → Forms → General → Enable forms system. Also confirm that your WordPress role has access to POM Forms.

An active form is missing from the page builder

1. Open Forms → All Forms.
2. Confirm that the correct form is Active.
3. Save it again if its status recently changed.
4. Reload the page editor.
5. Open POM Form and search again.

Make sure you are editing the same site in a multisite network.

The form displays but will not submit

Check:

• required fields and validation messages;
• hidden fields with active required rules;
• conditional branches;
• file size and type restrictions;
• anti-spam or reCAPTCHA configuration;
• browser errors caused by custom scripts;
• whether the page is serving an old cached form.

Temporarily test a copy with no custom CSS or external automation to isolate presentation from submission behavior.

The visitor sees a generic error

A generic message can protect technical or sensitive details. Reproduce the issue with the simplest valid submission and identify which stage fails:

1. field validation;
2. file upload;
3. form processing;
4. notification delivery;
5. storage;
6. webhook or post creation;
7. success redirect.

Do not paste credentials, personal submissions, access tokens, or complete request data into a support message.

Administrator email does not arrive

1. Verify that the intended notification route matched the submitted values.
2. Check its recipient, From, and Reply-To settings.
3. Submit with a normal public email field value.
4. Check spam and mail quarantine.
5. Verify the site's outgoing mail service with another WordPress email.
6. Review the mail provider's delivery log when available.

If other WordPress mail also fails, correct site mail delivery before changing the form.

Merge tags appear unchanged

Use the form's merge-tag picker and confirm that the referenced field name still exists. The syntax for a field named email is:

{{field:email}}

If a field was renamed, update subjects, messages, routes, webhooks, defaults, and post mappings that use it.

A hidden field blocks submission

Open the field's required and conditional settings. Test the branch that hides it after first activating it. A visitor should not be asked to correct a control that is not visible.

Uploads fail

For local uploads, review:

• the form field limit;
• the site-wide maximum under Settings → POM Theme → Forms → General;
• allowed MIME types;
• the number of selected files;
• the WordPress/server upload limit.

For Google Drive fields, run the connection test and use Google Drive uploads.

A multi-step form loses progress

Check that custom JavaScript is not replacing the form or forcing a page navigation. Test Back and Continue without browser autofill, and confirm that every field remains inside the intended step, row, and column.

The success redirect does not work

Use a complete trusted URL, save the form, clear the page cache, and test while signed out. Confirm that the URL is not blocked by a redirect or security rule.

Duplicate submissions

Enable the loading indicator and post-success disable behavior. Check for:

• double-clicks caused by unclear feedback;
• custom scripts that call submit;
• page-cache or optimization scripts that initialize the form twice;
• an external receiver that creates duplicates while retrying.

Before requesting support

Record:

• the form title and public page URL;
• the field or tab involved;
• the exact steps to reproduce the issue;
• the expected and actual result;
• whether it occurs while signed out;
• whether a simple form works;
• whether email, storage, upload, or an external integration is affected;
• a screenshot with personal data removed.