Skip to content

Frequently asked questions

Do I need an API key to use the AI features?

Section titled “Do I need an API key to use the AI features?”

No. The managed AI mode is the default and handles everything server-side — no API key required on your end. Your Pro licence includes AI credits. Install, activate, and the AI form builder and agentic workflows work immediately, with no configuration.

If you want to use your own API key — for more control, higher limits, frontier-model access, or privacy reasons — you can switch to BYOK mode in Settings → AI → BYOK. This routes inference requests directly from your server to your chosen AI provider (OpenAI, Anthropic, Google, etc.) at your cost.


What’s the fair use policy on managed AI?

Section titled “What’s the fair use policy on managed AI?”

The managed AI credit allocation is designed to cover typical usage comfortably within your plan tier. We don’t publish hard per-submission numbers because usage varies significantly depending on workflow complexity, reply length, and number of AI actions.

In practice, the vast majority of AmazingForms sites never come close to the limit. If you’re running unusually high volume — thousands of AI-processed submissions per day — we’ll reach out to discuss options. You can always switch to BYOK mode for effectively unlimited usage at your own API cost.

View your current usage in Settings → AI → Usage dashboard.


Managed mode uses cost-efficient models — currently Flash-class models (similar tier to GPT-4o mini). These models are fast, inexpensive, and handle the vast majority of lead qualification and reply-writing tasks with high quality.

In BYOK mode, you choose the model per workflow. You can use frontier models (Claude Sonnet/Opus, GPT-4o, Gemini Pro) for workflows where output quality is critical, and cheaper models for simpler notifications.


Can I mix managed AI and BYOK on the same site?

Section titled “Can I mix managed AI and BYOK on the same site?”

Yes. You can set a global default (Settings → AI) and then override the model on individual workflows. For example, run most workflows on managed AI but use BYOK with Claude Opus for a high-value sales enquiry form.


Is form submission data sent to third-party AI providers?

Section titled “Is form submission data sent to third-party AI providers?”

Managed mode: yes, submission data is sent to AmazingForms’ managed AI proxy, which forwards it to a third-party model provider (currently Google or OpenAI Flash-class endpoints) to process the workflow. Data is transmitted over TLS, used only to process your specific request, and is not used for AI model training. See the AmazingForms Privacy Policy for full details.

BYOK mode: data goes directly from your WordPress server to your chosen AI provider’s API. AmazingForms does not see the data in transit. Your chosen provider’s privacy terms apply.

If you handle sensitive personal data (health information, financial data, legal matters) and have strict data residency or processing requirements, BYOK mode gives you full control.


Can I use AmazingForms with my existing Gravity Forms data?

Section titled “Can I use AmazingForms with my existing Gravity Forms data?”

Yes. You can export your Gravity Forms entries as CSV (Gravity Forms → Import/Export → Export Entries) and import them into the AmazingForms CRM (AmazingForms → CRM → Contacts → Import CSV).

The AI column-mapper will attempt to match your CSV columns to AmazingForms contact fields automatically. Review the mapping before confirming the import. Custom fields you’ve created in AmazingForms CRM can be targets for import mapping.


What happens if the AI workflow fails or times out?

Section titled “What happens if the AI workflow fails or times out?”

The submission is always saved first — data is never lost due to a workflow failure.

If the workflow fails (timeout, model error, invalid action config), the submission is saved with an error status. You’ll see an error badge in AmazingForms → Submissions.

To re-run the workflow:

  1. Go to AmazingForms → Submissions
  2. Open the submission with the error
  3. Click Re-run workflow

The AI Log tab on the submission shows the exact error and which step failed.


Yes. The WordPress plugin itself is licensed under GPL v2, as required by WordPress.org. You can view, modify, and redistribute the plugin code under GPL terms.

The managed AI proxy, the NL→workflow training corpus, and the proprietary model fine-tuning are separate server-side services — these are not GPL and are not distributed with the plugin. The value of the managed service is in those proprietary components.


Cancel auto-renewal from your Freemius account dashboard — the link is in your licence email (subject: “Your AmazingForms licence”). You keep full Pro access until the end of your current billing period. No partial refunds for unused time beyond the 14-day guarantee window.


Yes — AmazingForms offers a 14-day money-back guarantee, no questions asked. To request a refund, email support@amazingforms.com within 14 days of purchase with your order number. Refunds are processed within 5–7 business days via your original payment method.

See the Refund Policy for full terms.


Your form submissions, CRM contacts, and settings remain in your WordPress database — they are not stored on AmazingForms’ servers (with the exception of managed AI credit tracking). If you deactivate or delete the plugin, all data remains in your WordPress database tables. You can export contacts and submissions to CSV before cancelling.


Does it work with page builders (Elementor, Divi, Beaver Builder)?

Section titled “Does it work with page builders (Elementor, Divi, Beaver Builder)?”

Yes. Embed any AmazingForms form using:

Shortcode (works in any page builder’s text/HTML block):

[amazingforms id="X"]

Replace X with your form’s numeric ID (shown in AmazingForms → Forms).

Gutenberg block (native block editor): Search for “AmazingForms” in the block inserter and select the form from the dropdown.

The shortcode method works in Elementor’s HTML widget, Divi’s Code module, Beaver Builder’s HTML module, and any theme or plugin that processes WordPress shortcodes.


What PHP and WordPress versions are required?

Section titled “What PHP and WordPress versions are required?”
RequirementMinimumRecommended
WordPress6.3Latest stable
PHP8.08.2+
MySQL5.78.0+

AmazingForms uses custom database tables and requires CREATE TABLE privilege for the database user during activation.


Does it work with caching plugins (WP Rocket, LiteSpeed, W3 Total Cache)?

Section titled “Does it work with caching plugins (WP Rocket, LiteSpeed, W3 Total Cache)?”

Yes, with one consideration: form submissions go to a REST API endpoint that must not be cached. Most caching plugins exclude REST API routes by default.

If you experience form submissions not working on a cached site, add the AmazingForms REST API base (/wp-json/amazingforms/) to your caching plugin’s exclusion list.


AmazingForms can be activated per-site on a WordPress multisite network (not network-activated). Each site has its own forms, CRM, and licence. Network-wide activation and central management across sites is not currently supported.