Skip to main content

Activities & Activity Elements

An Activity is a form, survey, or check-in that you build to gather data from your participants. They are the core of how you track progress and engage with users, and each Activity is made up of one or more Activity Elements.

General Activities

A general Activity (like a Questionnaire or Reflection) is designed to be scheduled. You can assign it to a participant, or as part of a recurring action plan within a Journey. This allows you to prompt the user to complete it on a regular basis, for example, every Monday morning.

Example

Imagine a coach wants to track a participant's mood at the start of every week.

  1. They create a standard Activity named 'Weekly Mood Check-In'.
  2. Inside, they add a single multiple-choice Activity Element: "How is your mood today?" with scored options like 'Great', 'Okay', and 'Not Good'.
  3. They then add this Activity to a recurring action plan in the participant's Journey, setting it to appear every Monday.

Health Measures

Health Measures are a special type of Activity designed specifically for ongoing, self-paced tracking by a participant.

A Health Measure is unique because it is unscheduled. Once assigned to a participant, it remains persistently available in their app. This allows them to enter data at any time and as often as they like, which is perfect for logging metrics like weight, sleep hours, or pain levels on an ad-hoc basis.

Example

Imagine a coach needs a participant to log their weight regularly, but on a flexible schedule.

  1. They create a Health Measure named 'Log Your Weight'.
  2. Inside, they add an Activity Element with the 'Number' format and set the unit to 'kg'.
  3. Once assigned, this measure is always available in the participant's app, allowing them to enter their weight whenever is convenient.

Building an Activity: The Activity Elements

An Activity Element is the individual field you add inside an Activity to collect a piece of data. Activity Elements are created within an activity and are specific to that activity.

Activity Element Preamble

Every Activity Element, regardless of its format, can include optional preamble Content such as text or images to provide instructions or context to the participant before they answer.

Activity Element Format

When you add an Activity Element, you must choose a format that determines how the participant will answer.

  • Text/Multiple Choice: This versatile format can be used for both open-ended text responses and for selecting from a list of predefined options.
    • Example with Options: "Which of these best describes your energy levels?" with predefined, selectable options like 'High', 'Moderate', and 'Low'.
    • Example without Options: "What is one thing you are grateful for today?" where the participant types their answer into a text box.
  • Number: This format is for numerical input and can be displayed in two ways.
    • Example as a Slider: "On a scale of 1-10, how would you rate your sleep quality?" where the participant drags a slider to select their rating.
    • Example as a Single Input: "How many minutes of exercise did you complete today?" where the participant types a number into a field.
  • Yes/No: A simple choice between two options.
    • Example: "Did you complete your morning exercise today?".
  • Content Page: Use to display information (text, images, or video) without requiring a response.
    • Example: A page that displays a "Welcome to Week 2" message and a short instructional video.

Scoring and Data

You can configure your activities to automatically calculate a total score based on participant responses.

How Activity Scoring Works

First, you select a Scoring Strategy for the overall Activity that determines how the individual scores are combined. Then, you set the score for each option within your individual Activity Elements. An optional Score Multiplier can be used to scale the final result.

The available scoring strategies are:

  • Sum: Adds the scores from all answered Activity Elements to produce a total (e.g., 2 + 3 + 1 = 6).
  • Average: Calculates the mean score of all answered Activity Elements. This strategy also considers the Weight you can assign to each Activity Element, giving some Activity Elements more importance than others.
  • Min: Finds the single lowest score from all the answered Activity Elements.
  • Max: Finds the single highest score from all the answered Activity Elements.
  • Median: Finds the middle score after all answered Activity Elements' scores are sorted.
  • Concat: Joins the answers from all Activity Elements into a single text string. This is useful for non-numeric, text-based activities.
  • None: No scoring is calculated for this activity.

Referencing Previous Responses in Activity Element Content

When building an Activity with multiple elements, you can make later elements feel personalised by referencing a participant's answer to an earlier one. This is done by inserting a placeholder into the preamble content of any Activity Element using the syntax {values.ELEMENT_CODE}.

The ELEMENT_CODE is the Code field of the Activity Element you want to reference. This is the same code used in Journey signal conditions. You can copy this syntax directly from the Activity Element form using the copy button next to the element name.

note

The copy button is only available once the Activity Element has been saved, as saving generates the element's code.

Example

Imagine you are building a weekly check-in Activity with three elements:

  1. "Rate your mood today" — a Number slider from 1–10 (Code: MOOD_SCORE)
  2. "What activities did you do this week?" — a multi-select Text/Multiple Choice element (Code: WEEKLY_ACTIVITIES)
  3. "Reflection" — a follow-up Content Page

In the Reflection element's preamble content, you write:

You rated your mood as {values.MOOD_SCORE} out of 10 and completed {values.WEEKLY_ACTIVITIES} this week. Let's reflect on how these activities affected your wellbeing.

If the participant rated their mood as 7 and selected "Running" and "Yoga", they will see:

You rated your mood as 7 out of 10 and completed Running, Yoga this week. Let's reflect on how these activities affected your wellbeing.

This works across all Activity Element formats:

  • Text/Multiple Choice — inserts the selected option or typed text. For multi-select elements, multiple answers are joined with commas (e.g. "Running, Swimming, Reading").
  • Number — inserts the number as text (e.g. "7" or "8.5").
  • Yes/No — inserts the option label (e.g. "Yes" or "No").
  • Date/Time — inserts a formatted date (e.g. "3 March 2026").
  • Content Page — not applicable (no response to reference).
note

This only works for elements answered before the one containing the placeholder. If the referenced element hasn't been answered yet, the placeholder is left as-is.