bookmark_borderCreating a Feed for the User Registration Add-On

After you have installed the User Registration add-on for Gravity Forms, you’re ready to begin creating a feed. A feed is used to pass form submission information over to the add-on. Without it, the User Registration add-on won’t know how to handle the data.

Note: If you have not already installed the User Registration add-on, and need help doing so, take a look at the Downloading and Installing the User Registration Add-On article.

Accessing Your Feed

  1. To access feeds for the User Registration add-on, first access the form that you want to use with user registration.
  2. user-registration-feed-access-1At the top of the page, you will see an option labeled Form Settings. Simply hover over it and click on User Registration.
  3. user-registration-feed-access-2Here, you will see any feeds available within the User Registration add-on. You likely won’t have any available here if you have not previously used this add-on. Simply click the Add New button at the top of the page to begin creating a new feed.

Configuring your Feed

Now that you are on the Feed Settings page, it’s time to begin configuring your newly created feed.

Feed Settings

User Registration Feed Settings

  1. user-registration-feed-nameThe first option available on this page is the Name field. This field is simply used to identify the feed within the admin. Enter a name that will help you identify this feed if you later need to make changes to it.
  2. user-registration-feed-actionNext is the Action option. Within this option, you will select if you would like to use this feed to create a new user or update an existing user. The most common setting here is Create User. In the next steps, we will go over this option. If you instead need to update users, many of the same fields are available there as well.

Note: The same form cannot be used for new user registrations and user updates simultaneously. If you would like users to be able to register as well as update their details, you will need to create separate forms for each of the actions.

User Settings

User Registration Feed User Settings

  1. user-registration-feed-usernameThe first option within the User Settings section is Username. Within this option, you will use the drop down to select the field that will be used to set the username of the newly created user.
    As this is a required setting, be sure that an appropriate field exists within your form. If not, be sure to jump back to your form and add a text field in which a user is able to enter their username.
  2. user-registration-feed-first-last-nameNext up is the First Name and Last Name options. Here, select the corresponding form fields in which your user would enter their first and last names. While these are optional settings, they are highly recommended as they will help immensely if you need to review or edit users.
  3. user-registration-feed-nicknameThe Nickname field will allow the user to have a name different from their username or first/last names. For example, my legal name is Jeffrey Matson, but I often go by Jeff. If I don’t want to display my username on new posts or other content, setting a nickname will allow me to change that.
    If not set, the content of the Username will be used for this field when the user is created inside WordPress.
  4. user-registration-feed-display-nameNext up is the Display Name setting. This setting allows you to set the display name for the user, based on existing information within the user’s profile, such as {nickname}, {username}, or {first name}. By default it will use the Nickname set. If the user has not defined a nickname during registration, the username will be used.
  5. user-registration-feed-emailAnother required setting is the Email Address. When the user is created, it will use the contents of the form field defined here within the user profile, and is used for things like user activation or password generation/resets.
  6. user-registration-feed-passwordThe Password setting will allow you to either choose a specific field within the form which a user can create their own password, or automatically generate a password for the user.
  7. user-registration-feed-roleThe final required field within the User Settings section is Role. Using the dropdown, you will select the role of the newly created user within your site.
    Note: Be very careful when selecting a user role. For example, setting the Administrator role will grant users created with this form full access to your site and all settings. For more information on user roles and capabilities, take a look at the Roles and Capabilities article on the WordPress codex.

User Meta

User Registration Feed User Meta

In this section, you will be able to add custom meta values to the user. Using the Select Meta Key dropdown, you are may select an existing meta key or define a new custom meta key by selecting Add Custom Meta, and entering it into the text field that displays.

To the right of the user meta key, you will then select the field that will be used for the value within this meta key.

If you want to add more user meta information, just click on the “+” button to the right of the setting.

Additional Options

User Registration Feed Additional Options

  1. First within this section is the Send Email option. If you would like to send an email to the newly created user, containing their password, enable this option.
    Note: If you are automatically generating password within your user feed, be sure to leave this enabled as without it, the user will not be able to obtain their password without using a password reset on your site.
  2. Enabling the User Activation setting will require additional action before the newly registered user is created, either via email sent to the user or manually by an admin.
  3. Just like other Gravity Forms add-ons, the User Registration add-on supports conditional logic. This can be used to only register users if a specific condition is met.

Finishing Up

After each of your desired settings and configured, you’re ready to click that Update Settings button at the bottom of the page.

Once your settings are saved, the feed will be used to handle new user registrations, or update users through your form.