THIS IS A MIRROR ONLY. Please submit new PR's to our GitLab instance. Ninja Forms is a form creation framework for WordPress.
Kenneth Hall
Kenneth Hall Merge branch 'issue#3736' into 'develop'
Appeneded nf_db_version to the environment data being sent to telemetry.

Closes #3736

See merge request ninja-forms/ninja-forms!3678
Latest commit cc34599 Sep 18, 2018

Ninja Forms


Tags: form, forms, contact form, custom form, form builder, form creator, form manager, form creation, contact forms, custom forms, forms builder, forms creator, forms manager, forms creation, form administration, Requires at least: 4.7 Tested up to: 4.9 Stable tag: 3.3.16 License: GPLv2 or later

With a simple drag and drop interface you can create contact forms, email subscription forms, order forms, payment forms, and any other type of form for your WordPress site.


Ninja Forms is the ultimate FREE form creation tool for WordPress. Build forms within minutes using a simple yet powerful drag-and-drop form creator. For beginners, quickly and easily design complex forms with absolutely no code. For developers, utilize built-in hooks, filters, and even custom field templates to do whatever you need at any step in the form building or submission using Ninja Forms as a framework.

Here are just a few of the things you will find in Ninja Forms:

  • Special, easy to use fields for emails, dates (w/ datepicker), phone numbers, addresses and more
  • Modify your own field then save them as favorites to re-use later (even in other forms!)
  • Force required fields and correct data formatting with custom input masks
  • Give your users a success message or redirect them elsewhere after they complete a form.
  • Manage, Edit, and Export form user submissions.
  • Export and Import forms and favorite fields.
  • Email form data to administrators and/or users every time a form is processed.
  • Customize emails and add raw HTML(for photos, videos, and more) with the powerful Summernote HTML editor.
  • Several anti-spam options including Google reCaptcha, question/response fields, and honeypot fields
  • Form submission via AJAX, allowing a seamless user experience without page refreshes
  • Please note that if you are using a version of PHP lower than 5.3, you may experience some problems using AJAX Submissions. These can be minimized by using simple success/error messages without any quotes or special characters.


We have more integrations than any other WordPress form builder, with more added regularly!

  • PayPal Express - Accept payments using PayPal Express and Ninja Forms!
  • Front-End Editor - Give your users the ability to create, edit, or delete posts, pages, or any custom post type and allow your users to edit their Ninja Forms submissions all from the front-end. Also included is front-end profile editing, custom registration forms, login and password resetting, all without needing to see the default, WordPress branded login page.
  • File Uploads - Allow users to upload files and store those files within a searchable database.
  • Multi-Part Forms - Break up those long, complex forms into multiple pages.
  • Save User Progress - Let your users save their progress and return later to finish filling out the form.
  • Conditional Logic - Create "smart" forms that show or hide fields based upon user input. Even add a value to a dropdown list when a user selects a specific value from another list.
  • Front-End Posting - Use Ninja Forms to create posts from the front-end. These can be added to any post type, including custom post types, and users can select categories and tags.
  • Layout & Styles - Use Ninja Forms to create amzing form layouts and styles right from your WordPress admin.
  • MailChimp - The MailChimp extension allows you to quickly create newsletter signup forms for your MailChimp account using the power and flexibility that Ninja Forms provides.
  • Campaign Monitor - The Campaign Monitor extension allows you to quickly create newsletter signup forms for your Campaign Monitor account using the power and flexibility that Ninja Forms provides.
  • User Analytics - The User Analytics extension will help website owners understand how hot a lead is based on extra data automatically collected about the user.
  • Constant Contact - The Constant Contact extension allows you to quickly create newsletter signup forms for your Constant Contact account using the power and flexibility that Ninja Forms provides.
  • Pushover - When email and SMS notifications just do not cut it, send yourself push notifications of form submissions with Pushover. Pushover makes it easy to send real-time notifications to your Android and iOS devices.

If you're a developer and would like to talk about creating some premium extensions for Ninja Forms, send us an email:


If you're a developer and want to help make Ninja Forms better, we would love to work together! We know contributing to a project can be intimidating; sometimes it’s hard to tell how to get involved. We believe Ninja Forms is a great community to get involved in. In our experience, everyone involved with the project has been amazing and helpful. :) Here are some friendly guidelines. You can also join our development community here.

Please Note: GitHub is for bug reports and contributions only - if you have a support question or a request for a customization, please contact Ninja Forms Support instead.


To see up to date screenshots, visit Ninja


This section describes how to install the plugin and get it working.

  1. Upload the ninja-forms directory to your /wp-content/plugins/ directory
  2. Activate the plugin through the 'Plugins' menu in WordPress
  3. Visit the 'Forms' menu item in your admin sidebar

Shortcodes have been re-implemented. They are used like so: [ninja_forms id=#] where # is the ID number of the form you want to display.


For help and video tutorials, please visit our website: Ninja Forms Documentation

Requested Features

If you have any feature requests, please feel free to visit and let us know!