Skip to content
Docs

Profile Progress

The Profile Progress tab shows members how complete their profile is and can require them to finish it. Settings are stored in the blpro_profile_progress option.

Progress bar

Section titled “Progress bar”

Turn on Show the progress bar (progress_bar) to display a completion percentage bar on member profile headers. On BuddyBoss it hooks bp_before_member_header_meta; otherwise it hooks bp_profile_header_meta. The bar respects the viewed member’s profile-visibility level, so it is hidden when the viewer is not allowed to see the profile.

What counts toward completion

Section titled “What counts toward completion”

Choose which items count when calculating the percentage:

  • Extended profile field groups - pick which xprofile field groups are included.
  • Profile Photo - counted when profile avatar uploads are enabled.
  • Cover Photo - counted when cover image uploads are enabled.

Repeater field groups only count their first field set. The completion figure can be adjusted with the BP_reign_user_progress filter.

Mandatory requirements (force profile completion)

Section titled “Mandatory requirements (force profile completion)”

Require members to complete items before they can use the community. Each requirement has its own reminder message:

  • Require all mandatory fields (all_req_fields) - all required xprofile fields must be filled. Reminder: “Incomplete fields message”.
  • Require a profile photo (req_profile_photo) - an avatar must be uploaded. Reminder: “Profile photo reminder”.
  • Require a cover image (req_profile_cover) - a cover image must be uploaded. Reminder: “Cover image reminder”.

When a requirement is unmet, the member is redirected to the relevant profile edit screen (the fields edit tab, the change-avatar tab, or the change-cover-image tab) with the reminder shown as a notice. This runs on bp_template_redirect.

Exceptions handled in code:

  • Super admins are never forced to complete their profile.
  • The check is skipped on AJAX requests and on the member’s own profile screen (so they can actually edit it).
  • The whole check can be bypassed with the bp_force_profile_completion_skip_check filter.
Section titled “Related developer hooks”

Field, avatar, and cover checks each expose a filter for custom logic. See Hooks and filters.