About

This Activity Template enables the creation of linear or simple branching storylines, ideal for delivering visually engaging, multimedia-rich content, including images, animated GIFs, and audio.

Example of the Choose Your Adventure Activity Template in Web and Mobile view

In this Activity Template, each Activity is a single-story experience. Within a story, each Content Block (defined within a specific Activity’s Topic) translates to a single app page (or app screen) within the story.

How to set up

Create a Topic
When creating a Topic to be used with this Activity Template, ensure it is set with the following attributes:
- Type = SURVEY
- Content type = MIXED
Create an Activity
After you have created Content Blocks inside a Topic, you need to create an Activity to link to that Topic. Ensure the Activity has been set with the following attributes:
- Name = The name displayed to the user for the Activity
- Topic = The Topic you wish to assign to this Activity
- Template = Choose Your Adventure
Now if you navigate to the Explore tab in your mobile/web application, you will see your newly created Activity.
Launch the Choose Your Adventure Story Builder Editor
The Story Builder Editor allows you to easily create linear or simple branching storylines.

Below is an example of how a Story Builder Editor looks:

In order to access the Story Builder Editor interface, follow the steps below:
1. Refresh/reload the Creator webpage and navigate to the Activity you just created with the Choose your Adventure Activity Template.
2. Click Launch template content editor.

Story Builder Editor

The Story Builder Editor allows you to easily create linear or simple branching storylines, using the Choose Your Adventure Activity Template.

Here you can modify the sample story to make it your own! There are three main sections:

The Page List sidebar on the left-hand side shows all the pages (or app screens) of your story, which will be experienced by the app user in an ascending order (01 → 02 → 03 → …)
The center section shows the Story Page interface, as it will appear to your app users for the page (or app screen) currently selected. You can add images, text, audio by clicking Add options.
The right section of the interface shows additional page information which can be helpful to quickly see the relationship between other pages.

Tip: Remember to always press Save (top right-hand side) whenever you make any changes to your story. Otherwise, your changes will be lost.

You can also delete pages by selecting the Delete pages button (or Trash icon).

Add a new Page
Click + Add new at the bottom of the Page List, and enter a name for your new Page (or app screen).
Add images or audio files
To add an image or audio to your Page, click the relevant icon at the top of the blank Page, then select from existing files or upload a new one.

Click the "Add Image" button, then choose an existing file or upload a new one.
- Supported file types: JPEG, PNG, and GIF.
- Recommended image size: 1300x1300 px (for optimal responsiveness on mobile, tablet, and web)
Tip: You can upload animated GIF images. This will allow you to make your story more interactive.

Click the "Add audio" button to add/replace the audio/music that plays when the user opens the Page
- The supported file type is MP3.
Rearrange the Page order
You can change the order of your Pages by clicking and dragging the anchors on the right-hand side of each Page.
Add text
To add text, click Add text and type the text you wish to display on the Page.

Please note that the text will be displayed in a text box on top of the image in the lower half of the Page.

Note: If the image you have uploaded contains important elements/text, it may be blocked by the text box.
Add Options
To add options for the user to select when they are viewing a Page, click Add options.

You can have one or two options for the user to select from. Remove an option by selecting the X icon on the top right-hand side.

Enter the text to be displayed on the button in the text entry box.
Add Option Logic
Option Logic is what you use when you want to take users to a specific Page based on an option they have selected. For example, if you want app users to view Page 03 after selecting YES (rather than NO) on Page 01, you can use Option Logic to set that up.

By default, if no Option Logic is added for a Page, the user will be taken to the next Page (according to the Page List order). So, if you wish to show the user a specific Page based on their selected option, you can use Option Logic to control their experience.

To add Option Logic, press Add option logic on the desired option. You can then select the Page you wish for the option to link to.

Afterwards, you will see a text update that says Jump to [page]. This will allow you to test your story and ensure you have selected the correct Page.

In this example, Option Logic is being used to map the Yes/No options in Page 01 (ice cream) to Page 02 (Zoo) and Page 03 (boat) respectively.
Add Page Logic
Page Logic is what you use when you want to take your app users to a specific Page after viewing a particular Page. For example, if you want users to view Page 03 after viewing Page 01, you can use Page Logic to set that up.

By default, if no Page Logic is defined, the user will be taken to the next Page (according to the Page List order).

To add Page Logic, click Add page logic, which is at the bottom of the Page. You can then select the page you wish to link to.

Afterwards, you will see a text update that says Jump to [page]. This will allow you to test your story and ensure you have selected the correct Page.

In the example above, we used Page logic to link Page 02 (zoo) to Page 04 (introduction). Therefore, the user will skip Page 03 (boat).