Skip to content

Troubleshooting ​

Emails don't arrive ​

  1. In the form's Email section, check that Send email notifications is on and the recipient is right, then select Send test email under Confirmation to visitor. It sends a test notification to the recipient, using the settings on screen.
  2. Look in the spam folder.
  3. Use a sender address on your own domain. Mail servers often reject mail that claims to come from another domain, such as a visitor's address or a free mailbox.
  4. With Joomla default, check Joomla's mail settings in System → Global Configuration → Server. With an email service, check its API key and that your domain is verified there.
  5. Look in the log.

See Emails.

The form doesn't show on the page ​

  • The form must be published.
  • A shortcode that shows as plain text means the NXForms plugin of type content is disabled; enable it under System → Plugins. In a Custom module, also set Prepare Content to Yes.
  • A shortcode that shows nothing points to a form that's unpublished or doesn't exist, or the visitor isn't allowed to view it: see View forms on the site in Options.
  • For an NXForms module, Show unavailable-form notice (admins only) tells you why when you're logged in on the site.

See Menu items, modules, articles and popups.

"This form is currently unavailable." ​

The form is paused: it uses features that aren't installed or enabled on this site. In Forms, it's marked Paused with a short note.

Most often these are NXForms Pro features: a form imported from NXP Easy Forms that uses them, or a form built with Pro after Pro was disabled or removed. Install and enable NXForms Pro and the form works again, with all its settings. An expired license doesn't pause forms.

A menu item still shows the old NXP Easy Forms form ​

The import copies forms and entries, but doesn't change menu items, modules or scheduled tasks. Edit the menu item, change Menu Item Type to NXForms → Single Form and choose the imported form, which keeps its ID. Replace old NXP Easy Forms modules with NXForms modules.

Uploaded files open without a login ​

On nginx, and on Apache with AllowOverride None, the web server must block the uploads folder itself. See File uploads and privacy.

Visitors see "Captcha verification failed" ​

Check that the Site Key and Secret Key belong to the provider chosen in the form's Security section, and that the keys are registered for your site's domain. Google reCAPTCHA needs v3 keys. See Spam protection.

"Too many submissions detected" while testing ​

The form's rate limit allows 3 submissions every 10 seconds from one address by default. Wait a little, or change it in the Security section in Full mode. See Spam protection.

If real visitors see it on a site behind Cloudflare or another proxy, they're sharing the proxy's address: fill in Trusted proxies in Options.

Options doesn't save ​

The NXForms - System plugin must be enabled. Enable it under System → Plugins.

Where NXForms logs problems ​

NXForms writes problems to administrator/logs/com_nxforms.log.php. Log level in Options → General decides how much it writes. Set Verbose debug while you look into a problem, and back to Warnings and above afterwards.