🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!

Gravity Forms Community Members Premium Add-on Setup Guide

Updated 9 min read Gravity Forms Integrations A–Z
On this page
  1. Video walkthrough
  2. What You Get
  3. Requirements
  4. Quick Start: Register a Member
  5. The Action: Create, Update or Both
  6. A New Member: Active at Once or With the Activation E-mail
  7. Profile Fields by Group
  8. The Profile Photo
  9. Groups, Activity and Member Type
  10. The Profile Tab
  11. Conditional Logic, Payments and Notes
  12. The Settings Page
  13. Frequently Asked Questions
  14. Does it work with BuddyBoss Platform?
  15. Can a form change the role of a member?
  16. Does it send the BuddyPress e-mails?
  17. Can a form join a private group?
  18. Does it work without the Extended Profiles component?

Video walkthrough

Gravity Forms BuddyPress: Sign Up Members, Fill Profile Fields, Join Groups (Free Plugin)
One Gravity form signs up BuddyPress members and fills their profiles Watch on YouTube

Community Members joins Gravity Forms and the free BuddyPress plugin. A feed turns any form into a sign-up or profile form for your community: it creates a new member, or updates the member who is logged in, fills the BuddyPress profile fields, sets the profile photo, puts the member into groups, posts an activity update and sets the member type. A second part of the same feed shows a form, and the member’s own entries, as a tab on the BuddyPress profile. BuddyBoss Platform uses the same BuddyPress functions, so the feed works there too.

A Gravity Forms sign-up form with name, email, phone, company, interests, birthday, profile photo, password, username, bio, level and group choices, filled in for a new community member
A sign-up form that fills the BuddyPress profile, the photo, the groups and the activity feed.

What You Get

  • A feed called Register or update BuddyPress member on any Gravity Forms form.
  • A new member who is active at once, with the BuddyPress welcome e-mail, or a new member who starts with the BuddyPress activation e-mail and finishes when the link is opened.
  • The profile of the logged-in member updated from the same form, on their own account only.
  • Your BuddyPress profile fields, listed by field group, mapped to form fields: text, text area, number, URL, phone, date, drop-down, radio buttons, check boxes, multi-select and acceptance.
  • The profile photo taken from a File Upload field and saved with the BuddyPress avatar functions.
  • Optional steps after the member exists: join public groups, post an activity update with merge tags, set a member type.
  • A tab on the BuddyPress profile with a form for the owner and read-only entries for other people.
  • Conditional logic, delayed payment support, entry notes for every step and a clear message when BuddyPress is missing.

Requirements

Gravity Forms 2.9 or newer, the free BuddyPress plugin 12 or newer with the Extended Profiles component switched on, WordPress 6.5 or newer and PHP 7.4 or newer. The add-on was tested with Gravity Forms 3.1.2 on PHP 8.3 and Gravity Forms 2.9.8 on PHP 7.4, each with BuddyPress 14.5.2 from wordpress.org. BuddyBoss Platform offers the same functions; the automated tests ran against BuddyPress only. Groups need the User Groups component and activity updates need the Activity Streams component. The add-on needs no outside service and sends nothing to other sites.

Quick Start: Register a Member

  1. Build a form with the fields you need: name, email, a username and a password if you like, and the answers you want on the profile. A File Upload field can carry the profile photo.
  2. Open the form, go to Settings, then Community Members, and add a feed. Leave the action on Register a new member, or update the logged-in member.
  3. Map the email field. Map the first and last name, and a username or a password if the form has them.
  4. In Profile fields, pick a BuddyPress field on the left and a form field on the right, and add a row for each answer you want on the profile.
  5. Choose the profile photo field, the groups, the member type and an activity text if you want them, then save.
  6. Send the form. The entry shows a note for each step, and the member appears in the BuddyPress member directory.
The Register or update BuddyPress member feed settings in Gravity Forms: action, new member flow, role, account fields and a list of BuddyPress profile fields from every field group mapped to form fields
The feed maps form fields to BuddyPress profile fields, listed by profile field group.

The Action: Create, Update or Both

The default action registers a visitor and updates a logged-in user. A visitor who sends the form gets a new account. A member who is already logged in updates their own profile, so one form can serve both people and never makes a second account. Two other choices fix the behaviour: Register a new member always creates an account, and Update the logged-in member only works for people who are logged in, and a visitor leaves a note on the entry and nothing else.

Safety is built in. The add-on never changes another person’s account: the member that is updated is always the one who sent the form. An email address that already belongs to an account is refused with a note, so a form can never take over an existing account. The email address of a member is not changed by an update.

A New Member: Active at Once or With the Activation E-mail

In the feed you choose how a new member starts. Active at once creates the account right away with a role you choose, saves the profile fields, sends the BuddyPress welcome e-mail (which holds a link to set a password) and records the new member in the activity stream, the way BuddyPress does after an activation. If the form has a password field, that password is used. If not, the member sets one from the welcome e-mail.

BuddyPress activation e-mail uses the BuddyPress sign-up itself. BuddyPress keeps a pending sign-up and sends its own activation e-mail. Nothing else exists yet. The add-on stores the profile answers, the groups, the member type and the activity text with the sign-up, and applies them when the member opens the link. BuddyPress then creates the user, saves the profile fields and sends its welcome e-mail, and the add-on adds the role, the photo, the groups, the member type and the activity update. The entry gets a note when the member activates, and the entry is then owned by the new member. A password typed in the form is stored hashed with the sign-up, as BuddyPress does.

Usernames follow the BuddyPress rules: at least four characters, no underscore and not only numbers. If the form has no username field the add-on uses first.last from the names, or the email address, and adds a number when the name is taken.

Profile Fields by Group

The Profile fields list is built from your BuddyPress profile field groups, so you see the same structure as in BuddyPress, Profile Fields. Every supported field type is listed with its type. Choose the BuddyPress field in the first column and the form field in the second. The value column also takes a merge tag text when you want a fixed or combined value.

  • Check boxes and multi-select fields send a list of answers. The answers must match the options of the BuddyPress field.
  • Date fields take a Gravity Forms Date field and are saved the way BuddyPress keeps dates.
  • Number fields keep numbers only, URL fields keep real web addresses and text areas lose markup.
  • The BuddyPress Name field is filled from the first and last name when you do not map it, so the member always has a display name.
  • When BuddyPress refuses a value, for example a drop-down answer that is not one of its options, the entry note names the field and the other fields are still saved.

When a logged-in member is updated, an empty answer keeps the current value if you leave that box ticked. Untick it to let an empty answer clear the field.

The Profile Photo

Pick a File Upload field as the profile photo. After the member exists the add-on crops the image to a square, resizes it to the avatar size set in BuddyPress and saves it with the BuddyPress avatar functions, so the full and thumb files sit where BuddyPress looks for them and every avatar in the theme shows the new photo. Only real JPG, PNG, GIF and WebP images are accepted; anything else leaves a note and the member keeps the current avatar. If your site switched profile photo uploads off in BuddyPress, the add-on respects that and leaves a note.

Groups, Activity and Member Type

Under Groups, activity and member type you can add three optional steps. Each one leaves a note on the entry.

  • Join groups. Tick the groups the member joins, or choose a form field whose answers name groups (a group name, its slug or its id). Only public groups are offered: private and hidden groups need an invitation or an approval, so a form never puts anyone in. The member joins as a plain member, never as an organizer or moderator.
  • Activity update. Write the text with merge tags, for example New member {Company:5} just joined. The text is plain: markup in answers is removed, so a visitor cannot put links or scripts into your activity feed through a form field.
  • Member type. Choose one of the member types registered in BuddyPress. A type that does not exist is refused with a note.

The Profile Tab

Switch on Show a tab on the BuddyPress member profile and give the tab a title. The tab appears on the member’s own profile, with the form on it and the member’s entries below it. When you let everyone who can see the profile read the entries, the tab shows on other people’s view of the profile too, read only; otherwise it stays hidden from them. Choose who can read the entries: only the owner (and people who may view Gravity Forms entries), everyone who can see the profile, or nobody. Other people never get the form and never see a way to change an entry; the entries are read only. You choose the fields shown (none ticked shows every visible field) and the entries per page. Hidden, password and similar fields are never shown.

A BuddyPress member profile with a Gravity Forms request form on its own tab, and below it the entries of that member, newest first, with a link to older ones
A form and the member’s entries on a profile tab, with the BuddyPress cover and avatar.

The form on the tab is an ordinary Gravity Forms form, so its own feeds run when the owner sends it: a profile update feed on the same form keeps the profile in step, and every entry is saved for that member. The tab was tested with the default BuddyPress template pack.

Conditional Logic, Payments and Notes

Use the Conditions section to run a feed only when an answer matches, for example only for people who tick a box. When the form takes a payment, the feed can wait until the payment is completed: the member is created once when the payment add-on releases the feed, and never twice. Each step writes a note on the entry, and an error is written as an error note, so you can see exactly what was done for each submission.

The Settings Page

Open Forms, Settings, Community Members to activate your license key. The feed fields only work with a valid license. The add-on adds the member user ID to the entry as a value you can filter on and use as a merge tag.

Frequently Asked Questions

Does it work with BuddyBoss Platform?

BuddyBoss Platform is built on BuddyPress and offers the same functions, so the feed is meant to work there. The automated tests of this release ran against the free BuddyPress plugin from wordpress.org, so please try a form on a test site first.

Can a form change the role of a member?

A new member gets the role you choose. The list never offers a role that can manage users or the site, and a logged-in member is only moved to the role of the feed when they are not an administrator.

Does it send the BuddyPress e-mails?

Yes. The activation e-mail and the welcome e-mail are the BuddyPress e-mails, with your template and your changes. The add-on does not add its own member e-mails.

Can a form join a private group?

No. Only public groups can be joined from a form. Private and hidden groups stay under the control of their organizers.

Does it work without the Extended Profiles component?

No. The feed needs the Extended Profiles component of BuddyPress. A notice tells you when it is switched off.

Need help? Open a support ticket and tell us your Gravity Forms and BuddyPress versions.

Still need help?

Our support team answers tickets every day, usually within a few hours.

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr