Form fields - Affiliate Forms for Ninja Forms

Note: This article relates to the Affiliate Forms For Ninja Forms pro add-on. The Affiliate Forms for Ninja Forms pro add-on requires the free 3rd-party Ninja Forms plugin.

The Affiliate Forms For Ninja Forms pro add-on provides compatibility with both the  current version of Ninja Forms, Ninja Forms 3, as well as older Ninja Forms 2.9 versions. Make sure to confirm the version of Ninja Forms you're using, and refer to the section below for the Ninja Forms version you're using.

Ninja Forms 3.0 or higher

Once you're on the New Form screen in Ninja Forms, AffiliateWP fields are located in Form Fields → AffiliateWP:

For registration to be valid, you'll need to add the following fields:

  • Email address
  • Affiliate Username

However, we recommend adding all of the registration fields available.

Note: The password field may not be visible since it depends on what Ninja Forms Extensions you have installed. To access the field, type 'password' in the top search area where it says Filter, and add them to your form.

Once you've added the affiliate registration fields, make sure you've also added an email field, which is located in Form Fields → User Information Fields.

Click here for a complete guide to creating an affiliate registration form using Affiliate Forms For Ninja Forms.

Optional fields remain the same as they are for Ninja Forms 2.9 below, and of course, you can add as many extra field as you'd like!

Ninja Forms 2.9 or lower

Available fields

There are four new field types available which you can use in your forms:

The affiliate will enter their desired WordPress username. The WordPress username is used in  Affiliate URLs.

Although the username field isn't required, if your affiliates intend on using the "username" variation of their referral URL, it would be a good idea to include it, and make it a required field. If the username field isn't added, an affiliate's WordPress username is created from their email address (which is required). Because of this, an affiliate will share their referral URL with their email address included.

Website URL
The affiliate will enter the site URL they will be promoting your website on.

Promotional Method
The affiliate will tell you how they will be promoting your website.

Payment Email
If the affiliate has a different email address that they use for payments they can enter it into this field.

In addition to the above, you can add any field you'd like!

Note: if affiliate approval is enabled the custom fields will be shown on the affiliate review screen (requires v1.6.2+), as well as in the standard Ninja Forms submissions area.

Required fields

At the very minimum, your affiliate registration form must have an  Email field. This is a standard Ninja Forms field. You can find it in the User Information section of the form editor.

If no email field is added, an error message will be shown at the top of the form and the form will be prevented from sending.

Optional fields

If no username field is shown, the username for the affiliate is created from their email address, and is included in an email to them after registration.

This is a standard Ninja Forms field found in the Template Fields section of the form editor. If no password field is shown, a random password will be generated for the affiliate and included in an email to them.

Promotional method
The affiliate will tell you how they will be promoting your website.

Website URL
The affiliate will enter the site URL they will be promoting your website on.

Note: just like the standard behaviour of AffiliateWP, when a user is logged in but not yet an affiliate, some fields are not required so they will not be shown (e.g. username, email, and password).