Back to Community
Home / Community / Plugin → Ninja forms – the contact form builder that grows with you

Troubleshooting Ninja Forms Export and Import Issues: A Comprehensive Guide

20 threads Sep 9, 2025 Plugin → Ninja forms – the contact form builder that grows with you

Content

Exporting and importing forms and submissions is a common task for WordPress site owners, especially during migrations or when moving from a staging to a live environment. Many users of the 'Ninja Forms – The Contact Form Builder That Grows With You' plugin encounter challenges with this process. This guide compiles the most frequent issues and their solutions, based on community reports and troubleshooting.

Common Export and Import Problems

Users often face several key issues when trying to move their Ninja Forms data:

  • Missing Bulk Operations: The plugin lacks a built-in bulk export/import feature for forms, requiring manual handling of each form.
  • Submissions Not Transferring: Form exports do not include submission data. Submissions are stored separately in the database.
  • File Extension Confusion: Exported form files (.nff) may be saved by browsers with an incorrect extension (e.g., .json or .csv), causing import failures.
  • Import Process Hangs or Fails: The import process may not complete, often due to server resource limits, PHP errors, or conflicts with other plugins.
  • Empty or Incomplete CSV Exports: Attempts to export all submissions can result in an empty CSV file, often due to server constraints or a large number of fields.

Why These Issues Happen

The structure of the plugin is a primary factor. Forms and their submissions are stored in different database tables. The form export feature is designed only to transfer the form's structure and settings, not the data collected by it. Furthermore, the import/export functionality relies on specific server configurations and can be interrupted by PHP errors, warnings (especially in WP_DEBUG mode), or insufficient resources like PHP memory or execution time.

Solutions and Workarounds

1. Manually Correcting File Extensions

If your exported form file has a .json or .csv extension, simply renaming it to have a .nff extension is a common and effective fix. The file's contents are JSON data, and the import tool can read it once the correct extension is applied.

2. Migrating Form Submissions

Since there is no built-in tool to import submissions, moving them requires a database operation. The recommended method is to identify and export the relevant Ninja Forms tables from your database (e.g., nf3_forms, nf3_submissions, nf3_form_meta) using a tool like phpMyAdmin, and then import them into the new site's database. This ensures all submission data is preserved correctly.

3. Addressing Failed Imports and Exports

  • Check for PHP Errors: Enable WordPress debugging temporarily. If the import/export fails and you see PHP warnings or notices in your wp-content/debug.log file, these errors may be breaking the process. Resolving them, often by updating a conflicting plugin, is necessary.
  • Increase Server Resources: For large forms or many submissions, increasing your PHP memory limit (memory_limit), maximum execution time (max_execution_time), and post max size (post_max_size) can prevent timeouts and failed processes.
  • Try a Different Browser: Some users report that exports from Firefox save with the wrong extension, while Chrome works correctly. If you encounter issues, try using a different web browser.
  • Ensure Plugin Compatibility: The import process will not work between major versions (e.g., you cannot import a form exported from Ninja Forms 2.9 into a site running version 3.0+). Ensure both sites are running the same major version of the plugin.

4. Handling Empty Submission Exports

If exporting all submissions results in an empty CSV, try exporting a smaller date range to see if the issue is related to the dataset's size. If that works, the problem is likely a server resource limit. Contact your hosting provider to increase available resources for the export operation.

Conclusion

While the 'Ninja Forms – The Contact Form Builder That Grows With You' plugin is a powerful tool, transferring forms and data between sites has specific limitations. Understanding that form exports and submission data are separate is the first step. For successful migrations, a combination of using the built-in tools correctly, manually managing database tables for submissions, and ensuring your server environment is properly configured will provide the best results.

Related Support Threads Support