Challenges

Challenges overview#

Challenges are time-bound competitions for your clients. You choose one thing to count and the dates, add the people who take part, and Fitora scores everyone automatically from the workouts and food they log in the client app. Nobody types in a score.

Open Challenges in the sidebar, under Manage. The list shows every challenge you can open: its cover, name and number of participants, its Mode, its Date range and its Status. Click a row to open the challenge.

From this page you can:

• Start a new challenge with + Add Challenge, or from a ready-made one with Templates
• Open a challenge to follow its leaderboard or badge board
• Edit or delete a challenge from the three-dot menu at the end of its row

Challenge modes#

The first step of a new challenge is its mode. The mode decides how progress is shown and who wins.

In the challenge list and on the challenge page, a milestone challenge is labelled Badge Board, after the board that takes the place of the leaderboard.

Ranks are never shared. On a leaderboard, a tie goes to the participant who reached the score first, then to whoever joined the challenge first. On a badge board, participants are ranked by badges earned, then by score, with the same tie-breaks.

Challenge types#

Every challenge counts one thing, chosen under Challenge Type. The type decides what adds to a participant’s score and the unit the scores are shown in.

Workout types

Nutrition types

Creating a challenge#

1. 1Open Challenges in the sidebar
2. 2Click + Add Challenge in the top-right corner
3. 3Choose Leaderboard or Milestone, then click Continue
4. 4Optionally click Change on the cover image to pick a different cover (see below). A new challenge starts with a default cover
5. 5Enter a Challenge Name (required, up to 50 characters)
6. 6Optionally enter a Challenge Description of up to 500 characters: the goal, the rules, the prize
7. 7Select a Challenge Type. The options are grouped, for example Workouts · Total Reps or Nutrition · Total Days Logged
8. 8For a milestone challenge, choose a Badge Theme and fill in the five Badge Milestones (see Milestone badges)
9. 9Set the Start and End dates
10. 10Click Create Challenge

The challenge opens straight away, ready for you to add participants.

Choosing a cover image

1. 1Click Change at the bottom right of the cover
2. 2Pick one of the ready-made covers, or click Upload Image to use your own
3. 3Check the preview and click Use Image

Dates and challenge status#

A challenge runs for whole days, from the start date to the end date, both included. The days follow the time zone of your browser when you create the challenge: it starts at midnight at the beginning of the start date and ends at midnight at the end of the end date.

• The start can be today or any later day, so you can schedule a challenge in advance
• A challenge runs for at least 3 and at most 62 days. The date pickers only offer end dates inside that range
• If the dates break a rule, the form shows Start today or later and run for 3 to 62 days. and Create Challenge stays disabled

The status follows the dates on its own: Upcoming before the start, Active while the challenge runs, Completed after the end. Coaches and clients see the same status and countdown, whatever their own time zone.

Milestone badges#

A milestone challenge has five badge tiers. Each tier has a threshold, and a participant earns the badge as soon as their score reaches it.

Choosing a badge theme

Pick a theme under Badge Theme. Each theme has its own names and emoji for the five tiers, lowest first:

Setting the thresholds

Under Badge Milestones, enter a number for each of the five tiers, in the challenge’s unit (workouts, kg, reps or days). Every threshold is required, must be a whole number above zero and must be higher than the one before it. Until they are, the form shows All badge thresholds are required and must be in ascending order.

For example, a Total Workouts Completed challenge with the Journey theme could use:

Starting from a template#

Instead of starting from scratch, you can start from a ready-made challenge with its name, description, badges and cover already filled in.

1. 1On the Challenges page, click Templates
2. 2Browse the Challenge Templates. Filter by mode (Leaderboard or Milestone) and by category, such as Workout or Nutrition. Click an active filter again to clear it
3. 3Sort with Featured, Duration (shortest first) or Duration (longest first)
4. 4Click a template card. Each card shows the cover, the name, a Featured tag or the mode, the description, the challenge type and the suggested length in days
5. 5The editor opens pre-filled with the template’s name, description, mode, type, badge theme, thresholds and cover. The start is set to tomorrow and the end to match the suggested length
6. 6Change anything you like, then click Create Challenge

Managing participants#

Clients take part and are scored. Coaches from your team can be added too: they follow the challenge and receive its notifications, but they are not ranked.

Adding participants

1. 1Open the challenge from the Challenges list
2. 2Click Manage Access in the header
3. 3In Manage Challenge Access, the left side lists the clients and coaches who are not in the challenge yet; coaches carry a Team tag. The right side, Members, shows who is already in
4. 4Search by name in Search clients and coaches
5. 5Tick everyone you want to add
6. 6Click Add to Challenge

New participants start at 0. Their score counts from the day they were added, or from the start date if that is later. Activity from before they joined does not count.

Removing participants

1. 1Open Manage Access
2. 2In Members, tick the people you want to remove
3. 3Click Remove, then confirm with Remove

Coaches in a challenge

The coach who creates a challenge is added to it automatically. Owners and admins see and manage every challenge in the workspace anyway; adding a standard coach is what lets them open the challenge, follow its leaderboard or badge board and receive its notifications. Only owners and admins can add or remove participants.

The challenge page#

A challenge opens with its cover and name, the photos of the first participants and the participant count. On the right of the header are Manage Access and the pencil icon for editing (for owners and admins, until the challenge is completed) and the bell icon for your notification settings.

The leaderboard or badge board fills the main area. Beside it, the About card shows:

• Your description, with See more when it is longer than 150 characters
• The challenge type, with a short explanation of what it counts
• The start and end dates, with a status line such as Day 12 of 30, Starts in 3 days or Completed
• The mode, Leaderboard or Badge Board
• For milestone challenges, Milestones: the five badges with their emoji, name and threshold

Viewing the leaderboard#

A leaderboard challenge shows the Leaderboard card:

• A countdown at the top right: the time left while the challenge is active, or Starts in … before it starts
• A podium for the top three, 🏆 first, 🥈 second and 🥉 third, each with their photo, name and score. A place stays empty until someone has scored more than zero
• A ranked table of everyone below the podium, with their place (4th, 5th …), name and Score in the challenge’s unit

Until anyone has been added, the card shows No participants yet.

Viewing the badge board#

A milestone challenge shows the Badge Board card instead of a leaderboard:

• Every participant in rank order: most badges first, then the highest score
• The participant’s current score under their name
• Five badges on each row: earned ones in full colour, the rest faded. Hover over a badge to see its name and threshold
• The same countdown as on a leaderboard, at the top right

Completion summary

When the challenge ends, a summary appears at the top of the board:

• The top achiever, with their badges out of five and their score
• Badges Earned: the badges all participants earned together
• Completed All: how many participants earned all five badges
• Completion Rate: the badges earned as a share of all the badges participants could have earned

What clients see in the app#

Clients see the challenges they have been added to in the client app on iPhone and Android. They can’t join a challenge on their own.

On the Home screen

A Challenges card on Home lists each challenge with its cover, name and type. A leaderboard row ends with the client’s rank, such as #3; a milestone row shows the five badges, with the earned ones in colour. Tapping a row opens the challenge.

On the challenge screen

• The cover and name, with a status pill: Starts in … before the start, a countdown to the end while it runs, and Ended afterwards
• An info button that shows your description
• In a leaderboard: the podium, with You in place of their own name, and a numbered list of the other participants, where their own row is highlighted and marked (You)
• In a milestone challenge: the five badges on a track, their score, a progress bar with how much is left to the next badge, and All tiers unlocked! once they have all five. Tapping a badge explains how it was earned or what it takes. Below, every participant is listed with their badges
• Pulling down on the screen refreshes the scores

How progress is tracked#

Knowing exactly what counts helps you set expectations with clients. Two rules apply to every type:

• Only days inside the challenge dates count, and only from the day the client was added
• Days are the client’s own calendar days, in their time zone

Workout challenges

Progress is added the moment a client finishes a workout in the client app:

• Total Workouts Completed: each finished workout adds 1
• Total Workout Volume: the workout adds weight × reps, summed over every logged set that has both, in kg
• Total Reps: the workout adds the reps of every logged set

Nutrition challenges

Nutrition challenges count the food clients log in the food log of the client app. Each day is worth at most 1:

• Total Days Logged: any food log entry that day counts
• Calorie Target Days: the day counts when its total calories reach or exceed the client’s calorie target
• Protein Target Days: the day counts when its total protein reaches or exceeds the client’s protein target

The targets are the client’s macro targets for that day, including their rest-day targets on rest days. You set them on the client’s profile; see Nutrition. A client without a target never scores on target days.

Editing a challenge#

Owners and admins can edit an upcoming or active challenge. Click the pencil icon on the challenge page, or Edit in the three-dot menu of its row in the list. Change the fields and click Update Challenge.

What you can change:

• The name, description and cover
• The end date, as long as the challenge still runs for 3 to 62 days
• The start date, only while the challenge is Upcoming, and only to today or later

What stays fixed:

• The mode
• The challenge type
• The badge theme and thresholds

Deleting a challenge#

1. 1On the Challenges page, click the three-dot menu at the end of the challenge’s row
2. 2Click Delete
3. 3Confirm with Delete challenge

Challenge notifications#

Your notification settings

Coaches are told when clients climb. Each coach chooses their own notifications, per challenge:

1. 1Open the challenge
2. 2Click the bell icon in the header
3. 3Turn each notification on or off in Notification Settings. Every change saves at once

Automatic notifications

Fitora also sends these on its own at the key moments of every challenge:

Challenge notifications appear under the bell in the coach app and in the client app, and as push notifications on devices where notifications are allowed. Tapping one opens the challenge.