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.
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.