Skip to main content

Leaderboard Scoring Modes & Filters

How scoring modes, time periods, Exclude Today, Averages vs Totals, Smart View filters, and custom date ranges work on the Leaderboard.

Written by Xenios Charalambous
Updated over a month ago

The Leaderboard gives you powerful filtering and scoring options to run any type of competition. Here's how each one works.


Scoring Modes

The scoring mode controls how clients are ranked. Switch modes using the dropdown on the leaderboard page.

Overall

The default mode. Clients are ranked by a combined weighted score across all five metrics (workouts, nutrition, weight loss, habits, steps). The contribution of each metric depends on your scoring weights set in Settings. By default: Weight Loss 25%, Workouts 25%, Nutrition 20%, Habits 15%, Steps 15%.

Weight Loss Only

Clients are ranked purely by their weight change within the selected time period. The system compares their first recorded weight in the period to their latest weight. The unit system (kg or lbs) follows your business preference set in Preferences.

Workouts Only

Clients are ranked by workout completion rate — the percentage of scheduled workouts they've completed in the selected period.

Nutrition Only

Clients are ranked by nutrition compliance — how closely they hit their calorie and macro targets. A day counts as compliant if intake is within your compliance tolerance (default: 15% of goal), which you can adjust in Compliance Rules.

Habits Only

Clients are ranked by habit completion rate — the percentage of assigned habits they've completed in the period.

Steps Only

Clients are ranked by step count. You can toggle between two calculation modes:

  • Averages — average daily steps (better for comparing clients across different time periods)

  • Totals — total steps in the period (better for raw accumulation challenges)

Switch between Averages and Totals using the toggle on the leaderboard page.


Time Periods

Choose a time window to control which data is included in the rankings:

Period

Description

Last 7 Days

Rolling 7-day window from today

Last 30 Days

Rolling 30-day window (default)

Last 60 Days

Rolling 60-day window

Last 90 Days

Rolling 90-day window

Last Week

Monday to Sunday of the previous week

Last Month

Full previous calendar month

This Month

From the 1st of the current month to today

This Year

From January 1st to today

All Time

All available data since the client was added

Custom

Pick any start and end date using the date picker


Exclude Today

Toggle Exclude Today on to remove today's data from the rankings. This is useful because today's data is often incomplete — clients may not have finished their workouts or logged their meals yet. Excluding it prevents unfair scoring.

This toggle is available for both the internal leaderboard and the public leaderboard (configured separately in Settings → Public).

Note: Exclude Today is automatically disabled when using Custom, Last Week, or Last Month time periods since those periods don't include today.


Smart View Filter

If you use Smart Views to organize your clients, you can filter the leaderboard to show only clients from a specific smart view. Use the dropdown on the leaderboard page to select a smart view.

This lets you run separate competitions for different client groups — for example, a "Weight Loss Program" group vs. a "General Fitness" group — without them competing against each other.


Default Scoring Mode

You can set a default scoring mode so the leaderboard always opens on your preferred view. Go to Leaderboard → Settings → General tab and choose from: Overall Score, Weight Loss Only, Workouts Only, Habits Only, Nutrition Only, or Steps Only.

Did this answer your question?