User Profiles & Activity

Get Started

User Profiles & Activity

Time to read: 4 minutes

Show your community members their voting history, submissions, and engagement stats. Add profile cards to any page and build leaderboard pages to highlight your most active contributors.

What You’ll Learn

  • Adding user profile cards to your pages
  • What the profile card displays
  • Building a leaderboard page
  • Use cases for community engagement

Shortcode

Basic Usage

[roadmap_user_profile]

Displays the current logged-in user’s profile card. If the user is not logged in, nothing is displayed.

Specific User

[roadmap_user_profile user_id="42"]

Displays the profile card for user ID 42, regardless of who is viewing the page.

AttributeTypeDefaultDescription
user_idintegerCurrent userWordPress user ID to display

Profile Card

The shortcode renders a card with:

User Info

  • Avatar – WordPress gravatar
  • Display name – User’s display name

Stats

  • Total votes – Number of items the user has voted on
  • Total submissions – Roadmap items the user has created
  • Total comments – Comments on roadmap items

Recent Activity

  • Last 5 votes – Items the user recently voted on (linked)
  • Last 5 submissions – Items the user recently submitted (linked)

Use Cases

User Dashboard Page

Create a “My Activity” page for logged-in users:

[roadmap_user_profile]

Add it to your account area or member dashboard so users can track their own contributions.

Team Directory

Show profiles for key team members:

[roadmap_user_profile user_id="1"]
[roadmap_user_profile user_id="2"]
[roadmap_user_profile user_id="3"]

Top Contributors Page

Combine with the top contributors API endpoint to build a leaderboard page highlighting your most active community members.

Building a Leaderboard Page

Create a “Top Contributors” page to highlight your most active community members. This combines the shortcode with the REST API.

Simple Approach: Shortcodes Only

If you know your top contributors’ user IDs, create a page with multiple profile cards:

## Top Contributors

[roadmap_user_profile user_id="42"]
[roadmap_user_profile user_id="15"]
[roadmap_user_profile user_id="7"]

Update the user IDs periodically based on engagement.

Dynamic Approach: Custom Development

For an automatically updating leaderboard that refreshes without manual changes, a developer can use the Top Contributors API endpoint. See the Dynamic Leaderboard code example for ready-to-use code, or check the REST API Reference for details.

Leaderboard Page Structure

A typical leaderboard page includes:

  1. Page title — “Community Leaderboard” or “Top Contributors”
  2. Introduction — Brief explanation of how users earn their ranking
  3. Leaderboard list — Top 10-20 contributors with avatars and vote counts
  4. Call to action — “Vote on features to climb the leaderboard!”

For developer API endpoints and integration details, see the REST API Reference.

Troubleshooting

Profile card is empty

  • Verify the user has roadmap activity (votes, submissions, or comments)
  • Check that the user_id exists in WordPress
  • If using the default (no user_id), the viewer must be logged in

API returning empty results

  • The user may have no votes or submissions yet
  • Check the per_page and page parameters
  • Guest votes are not associated with user IDs

Top contributors shows unexpected results

  • Only logged-in user votes are counted (guest votes have no user ID)
  • The leaderboard ranks by total vote count only

Next Steps

  • Analytics Dashboard – Track overall engagement trends
  • Email & Notifications – Notify users about their voted items
  • Feedback Widget – Let users submit suggestions from any page

← Email & Notifications | Getting Started →

Last updated: March 4, 2026