# Ninja Forms - CiviCRM

`meteorgpl-plugin/ninja-forms-civicrm` — a WordPress plugin as a Composer package.

Ninja Forms integration with CiviCRM

- Author: Saturday Drive — http://ninjaforms.com/?utm_source=Ninja+Forms+Plugin&utm_medium=Plugins+WP+Dashboard
- Homepage: https://ninjaforms.com/docs/civicrm/
- License: GPL-2.0-or-later (profile: gpl-full)
- Buy a license from the vendor: https://ninjaforms.com/docs/civicrm/
- Latest version: 3.0.4 (2026-10-14)
- Page: https://meteorgpl.com/packages/meteorgpl-plugin/ninja-forms-civicrm
- Requires WordPress: 6.9
- Tested up to WordPress: 7.1
- Vendor: Saturday Drive — https://meteorgpl.com/vendors/ninjaforms.com

## About

This extension integrates Ninja Forms with CiviCrm

= Features =

* Create a new Contact; optionally match an existing logged in user as a contact
* Create multiple emails, phones, IMs, websites linked to Contact using pre-defined 'location names'
* Create multiple address linked to Contact using pre-defined 'location names'
* Create a new Activity linked to Contact
* Subscribe contact to multiple groups
* Add multiple tags to contact
* Register the Contact to a pre-existing Event using a numerical Event Id
* Add multiple line items for contact to events and memberships
* Add a note to the contact
* Add multiple contacts, each with the previously listed contact features
* Create an order consolidating all line items on the form
* Option to disable storage of communication diagnostics data (not the actual submission data)

## Changelog

### 3.0.4 — 2026-10-14

*Bug Fixes:*

- update a matched contact and its emails, phones, addresses, IMs and websites when the dedupe setting finds an existing contact
- send every selected option for checkbox and multi-select fields, not just one
- link the contact to its organization as current employer when an organization name is mapped
- apply the tag in the default tag row of the CiviCRM action
- offer only fields that can be used to create a contact in the contact field map
- prevent a fatal error on every page load when the CiviEvent component is disabled
- skip contact-linked actions and log the reason when CiviCRM rejects the contact save
- send the correct product name to the store so plugin updates are offered
- show the diagnostic results when viewing or clearing the log
- create the note on the contact when the note's entity type is left unselected
- stop creating blank email, phone, address, IM and website records for sections left empty

### 3.0.3 — 2026-06-30

*Bug Fixes:*

- fix fatal error on form submission when contact creation fails
- fix PSR-3 logging conflict with CiviCRM 6.15.2+

### 3.0.2 — 2024-02-20

*Bug Fixes:*
- Ensure class properties are declared
- Correct licensing key for automatic updates

*Other:*
- Update plugin header
- Add ReturnTypeWill change to prevent warnings

### 3.0.1 — 2023-01-31

*Bug Fixes:*
- Ensure dedupe match runs on downstream created records

### 3.0.0

* Use dropdown select for Group Id in contact map
* Use dropdown select for Tag Id
* Add template for hidden field
* Make tag entity hidden, set to contact
* Make Address Location dropdown w/ updated label
* Add ContactType to the Civi internal SDK
* Add field map config for type/subtype
* Add type/subtype to createNewContact request
* Add Country to the Civi internal SDK
* Add country to Address processor
* Add activity status and type using lookups
* Add DedupeRule and DedupeRuleGroup to SDK
* Pass deduperule group as contact match instruction
* Set newly created contact as AddedBy and With
* Add dedupeContact by email
* Don't add new contact info if isDupe
* Prevent PHP notices and warnings ading check rules
* Remove line item from CreateContact
* UI updates to match Ninja Forms standards
* Update documentation process
* Refactor release process

Full changelog: https://meteorgpl.com/packages/meteorgpl-plugin/ninja-forms-civicrm/changelog

## Install

```sh
composer config repositories.meteorgpl composer https://composer.meteorgpl.com
composer require meteorgpl-plugin/ninja-forms-civicrm
```

The repository needs a token (see https://meteorgpl.com/docs). The vendor's license checks are intact: activate the plugin in WordPress with a key bought from the vendor.

## Versions

| Version | Released | Size | SHA-256 | Status |
| --- | --- | --- | --- | --- |
| 3.0.4 | 2026-10-14 | 181.5 KB | 65ca1de5d61f2409fd18d64c88c9962c0f921935daf55c5f831198d1e7d5923e | verified |
| 3.0.1 | 2023-01-31 | 171.2 KB | 010ba3ee7ee41657fff35ee375e8fdaac763d00a80e9801b5a9acf2032abfd3f | verified |
| 3.0.0 | 2022-07-15 | 166.4 KB | 0ac4804e860cb03fa32be626fae54a30d62f4058032db2f296d055df51935f6f | verified |

