1. Form Creation Issues

Fields not appearing in the builder

Possible Causes:

• Builder not fully loaded
• JavaScript conflict
• Browser cache issues

Solution:

• Refresh the page
• Clear browser cache
• Disable other plugins temporarily to check for conflicts

Changes not saving

Possible Causes:

• AJAX request blocked
• Nonce expired
• Server security rules (mod_security)

Solution:

• Refresh the page and try again
• Ensure you are logged in with proper permissions
• Check browser console for errors
• Contact hosting provider if requests are blocked

Builder loading indefinitely

Possible Causes:

• JavaScript error
• Missing assets
• Plugin conflict

Solution:

• Open browser console (F12) and check for errors
• Disable other plugins and test
• Switch to a default theme temporarily

2. Form Design & Layout Issues

Form not displaying correctly

Possible Causes:

• Theme CSS conflicts
• Custom CSS overrides

Solution:

• Switch to a default theme to test
• Inspect elements using browser dev tools
• Add custom CSS fixes if needed

Columns not responsive on mobile

Possible Causes:

• Fixed widths in custom styles
• Missing responsive rules

Solution:

• Avoid fixed pixel widths
• Use percentage or flexible layouts
• Test using mobile preview

Theme not applying

Possible Causes:

• Theme CSS not loaded
• Cache issues

Solution:

• Clear site cache and browser cache
• Ensure theme files exist in /assets/styles/themes/

3. Form Functionality Issues

Conditional logic not working

Possible Causes:

• Incorrect field references
• Logic conditions not matching

Solution:

• Double-check field IDs and conditions
• Ensure values match exactly (case-sensitive)
• Test logic step-by-step

Required fields not validating

Possible Causes:

• Validation script not loaded
• Custom JS conflict

Solution:

• Ensure frontend scripts are loaded
• Check console for JS errors
• Disable conflicting scripts

Form submits but does nothing

Possible Causes:

• AJAX handler not triggered
• JavaScript error

Solution:

• Check browser console
• Verify form-submit.js is loaded
• Ensure no JS errors before submission

4. Submission Issues

Form submissions not received

Possible Causes:

• Submission handler failure
• Server blocking requests

Solution:

• Check submissions in dashboard
• Verify AJAX requests in browser network tab
• Contact hosting provider if blocked

Emails not sending

Possible Causes:

• Server email configuration issue
• Emails going to spam

Solution:

• Install an SMTP plugin
• Verify email addresses
• Check spam/junk folder

Duplicate submissions

Possible Causes:

• Multiple clicks on submit button
• No submission lock

Solution:

• Enable “disable after submit” behavior
• Add loading state to button

5. Spam & Security Issues

Receiving spam submissions

Possible Causes:

• No CAPTCHA enabled
• Weak protection settings

Solution:

• Enable honeypot (default)
• Add CAPTCHA (Turnstile, hCaptcha, or reCAPTCHA)
• Adjust rate limiting

Legitimate users blocked

Possible Causes:

• Over-aggressive spam protection
• Rate limiting too strict

Solution:

• Adjust rate limit settings
• Test form manually
• Review spam protection rules

6. Embedding Issues

Form not showing on page

Possible Causes:

• Incorrect shortcode
• Form not published

Solution:

• Verify shortcode syntax
• Ensure form is active
• Check page builder compatibility

Shortcode displays as text

Possible Causes:

• Shortcode not processed
• Page builder issue

Solution:

• Use a shortcode block/widget
• Ensure plugin is active

7. Submissions & Data Issues

Submissions not appearing in dashboard

Possible Causes:

• Storage issue
• Database error

Solution:

• Check database tables
• Ensure plugin has write permissions
• Re-save the form

CSV export not working

Possible Causes:

• Server restrictions
• Large dataset timeout

Solution:

• Try exporting smaller batches
• Check server memory limits

8. Remote Content Issues

Dashboard cards not updating

Possible Causes:

• Cached remote data (transients)

Solution:

• Clear cache manually
• Wait for cache expiration

9. Performance Issues

Form loads slowly

Possible Causes:

• Heavy theme
• Too many scripts

Solution:

• Optimize assets
• Reduce third-party scripts

Builder feels slow

Possible Causes:

• Large form schema
• Browser limitations

Solution:

• Simplify form structure
• Test in another browser

10. Permissions Issues

Cannot access builder or settings

Possible Causes:

• Insufficient user role

Solution:

• Ensure user has proper capabilities (e.g., Administrator)

Final Tip

If an issue persists:

• Check browser console (F12)
• Temporarily disable other plugins
• Switch to a default theme

Enable WordPress debug mode