Skip to main content

Contents and Content Types

A Content item is a piece of information, such as an article, guide, or link, that you can create and share with participants. Content is the foundation for building educational and engaging experiences within Journeys, Coaching and Action Plans.

A Content Type is a required category for every piece of content. It provides a way to classify and organise your content library. Think of them as folders for your articles and links, such as 'Sleep Hygiene', 'Nutrition Basics', or 'Mental Wellbeing'.

Every piece of content you create must be one of two formats:

Rich Text​

This format allows you to build articles directly within the platform. Your article is composed of Sections, and each section is built from Content Elements like text and assets.

  • Text Formatting with Markdown: Text elements support Markdown, following the CommonMark and GitHub Flavoured Markdown (GFM) specifications. This allows you to easily format your text with headings, lists, bold, italics, and more. CommonMark GitHub Flavored Markdown Spec
  • Assets: You can insert media directly from your Assets library. This is perfect for images, audio clips, and short video files.
  • Embedding Videos: For longer videos, it is suggested to use embeds. This method is more performant for participants and does not have the file size limits of uploaded Assets. You can embed videos directly using special tags:
    • YouTube: Use the <youtube src="https://www.youtube.com/watch?v={videoId}"/> tag.
    • Vimeo: Use the <vimeo src="https://vimeo.com/{videoId}"/> tag.
info

Don't include the brackets, they just mean insert the videoId <youtube src="https://www.youtube.com/watch?v=Z5-yYyM-A-s"/>

  • Direct Video File: Use the <video src="https://{videoUrl}"/> tag for other video URLs.

  • Dialable Phone Numbers: To make a phone number tappable so it opens the participant's dialler, write it as a Markdown link with the tel:// URI scheme. Use the international format (with country code, no spaces) in the URI; the visible label can be formatted however you like.

    [+64 21 421 904](tel://+6421421904)

Custom tags​

In addition to standard markdown, Rich Text sections support a small set of custom tags for layout and interactive elements.

Spacer — adds vertical space between content blocks. The height attribute is a numeric value and defaults to 24.

<spacer />
<spacer height="12" />

Text block — displays a block of styled text beyond what standard markdown supports. Attributes:

  • text — text to display
  • fontSize — numeric font size
  • align — left, center, right, or justify
  • color — hex colour value
<textblock text="You're not feeling yourself, and that's completely understandable. You're in the right place." fontSize="18" align="left" />

Custom button — displays a tappable button. Attributes:

  • text — button text
  • redirect — screen to navigate to (e.g. /home/1/1) or a custom app action (e.g. app://book-now)
  • icon (optional) — icon name, displayed to the left of the text
  • mode (optional) — solid, outline, or ghost (text only, no border). Defaults to solid
  • padding (optional) — numeric space around the button text
  • fontSize (optional) — numeric font size
  • width (optional) — numeric button width. Defaults to spanning the entire row
  • position (optional) — left, center, or right
<button text="Talk to a counsellor" icon="comment" redirect="app://book-now" padding="12" />

<button text="Try a guided journey" icon="route" redirect="/home/1/1" mode="outline" padding="12" />

<button text="Browse the Wellbeing Hub" mode="ghost" redirect="/home/1/0" fontSize="16" />
Example

Imagine a coach wants to create an article explaining the benefits of a good sleep routine.

  1. Content Type: The coach first ensures a 'Sleep' Content Type exists.
  2. Content Creation: They create a new piece of content named 'The Importance of Sleep'.
  3. Format: They select the Rich Text format to build the article internally.
  4. Content: Using the editor, they build the article with sections, format text with Markdown, and embed a relevant YouTube video using the <youtube/> tag.
  5. Save & Publish: Once the article is complete, they save and publish it to make it available for use.

This format redirects the participant to an external webpage, which is useful when you want to present content that is already on the web, such as news articles or other websites. You can personalise the link by adding {userId} to the URL, which will be automatically replaced with the participant's unique ID.

Example

Imagine a coach wants to share a detailed article from a reputable health website.

  1. Content Type: The coach creates and selects the 'Nutrition' Content Type.
  2. Content Creation: They create a new piece of content named 'Guide to a Healthy Diet'.
  3. Format: They select the External Link format.
  4. URL: They paste the URL to the external article in the provided field.
  5. Save & Publish: Once the link is complete, they save and publish it to make it available for use.

The Publishing System​

Content created in the Rich Text format uses a publishing system. When you are ready for your changes to go live, you must explicitly Publish the content. This action creates a new, locked version of the article, logs who published it and when, and makes it the live version for participants. This lets you make changes to the content without interrupting the participants experience.