WPConvert Forms Setup Guide

Step-by-step guide to the WPConvert Forms plugin — detect forms at conversion, install from your theme, wire to CF7/WPForms/Gravity, and test submissions.

WPConvert Forms Plugin: wire AI contact forms to Contact Form 7, WPForms, or Gravity Forms

AI builders generate contact forms visually — but after conversion, those forms are usually front-end HTML with no backend. Submissions fail silently, emails never send, and there is no server-side validation.

The WPConvert Forms Plugin wires your converted form markup to a real WordPress form plugin (Contact Form 7, WPForms, or Gravity Forms) while preserving your original design.

This guide covers detection at conversion, installation, wiring, and testing.


When the Forms plugin is included

WPConvert bundles the Forms plugin in your theme download when forms are detected during conversion on PRO, Agency, and PAYG plans.

You will find:

Starter conversions capture forms as static HTML without the wiring plugin. Upgrade to Pro if you need working form submissions.


Why AI forms break after conversion

Most AI builders output forms as client-side HTML:

The WPConvert Forms Plugin adds backend handling by connecting your visible form to a real form plugin — without replacing your layout with a shortcode block.


How wiring works

  1. During conversion, WPConvert parses forms and writes forms.json with page, template file, field types, and labels.
  2. When you wire a form, the plugin reads the manifest and creates a matching form in CF7, WPForms, or Gravity Forms with your recipient email.
  3. A hidden instance of the form plugin form plus a small bridge script is injected into the theme template.
  4. On submit, the bridge prevents the default submit, copies visible form data into the hidden form, and POSTs to the form plugin's API (e.g. CF7 REST endpoint).
  5. The form plugin handles nonce, validation, sanitization, and email. Success or error appears in your original form layout.

Your visible form keeps its HTML and CSS. Only submission is delegated.


Step-by-step setup

1. Convert with forms detected

Upload your AI-built site to WPConvert on a PRO, Agency, or PAYG plan. Confirm your export includes contact or signup forms. Download the theme ZIP after conversion completes.

2. Install the theme

Appearance → Themes → Upload Theme → activate your converted theme.

3. Install the Forms plugin

  1. Open your theme ZIP and locate plugins/wpconvert-forms.zip.
  2. Go to Plugins → Add New → Upload Plugin.
  3. Upload wpconvert-forms.zip, install, and activate.

4. Install a form handler plugin

Install one of:

The WPConvert Forms Plugin creates forms inside whichever plugin you choose.

5. Wire your forms

  1. Go to Tools → WPConvert Forms.
  2. Set your recipient email for submissions.
  3. Choose your form handler (CF7, WPForms, or Gravity).
  4. Click Wire All Forms (or wire individual forms).

The plugin creates corresponding forms in your chosen handler and connects your theme forms to them.

6. Test a submission

Visit the page with your contact form on the front end. Submit a test message. Confirm:

If email fails, configure SMTP via your form plugin or a plugin like WP Mail SMTP — the Forms plugin routes through your chosen handler's mail pipeline.


Supported field types

WPConvert detects and wires common field types:

Custom or unsupported types may need manual adjustment in the form plugin after wiring.


Submission logging and CRM

The WPConvert Forms Plugin sets up the form and recipient. Logging and CRM integrations are configured in the form handler you chose.


Troubleshooting

Form still does not submit

Confirm the Forms plugin is activated and forms are wired in Tools → WPConvert Forms. Check that your form handler plugin (CF7, etc.) is active.

Email not arriving

Test WordPress mail with a simple CF7 form first. If default mail fails, install an SMTP plugin and configure it for your form handler.

Design looks wrong after wiring

Wiring injects a hidden form and bridge script — it should not change visible markup. If styling breaks, check for CSS that targets form globally. Re-wire from Tools → WPConvert Forms if you change form handlers.

Re-wire or change form handler

Open Tools → WPConvert Forms to wire again or switch between CF7, WPForms, and Gravity Forms.