Creator Docs

Choice Layout

A Choice layout shows the options that the reader picks from. The Choices action shows it.

The layout has special elements that your visual novel fills in with the words of each choice. When the reader taps a choice, the story goes on with that choice.

The Preview tab of the My Choices layout on a phone. At the top middle of the canvas, the choices Go to the beach and Stay at home stand in a column. The Preview tab of the My Choices layout on desktop. At the top middle of the canvas, the choices Go to the beach and Stay at home stand in a column.

This example makes a column of choices in a new layout called My Choices.

Create the layout

  1. Create a layout. Under Layout Type, choose Choice. See Create a layout.
  2. Open the new layout. The Elements list is empty.

Add a column for the choices

The choices need a container that puts them in a column. Without it, all choices show in the same place.

  1. Add a Container. See Container.
  2. In the Elements list, tap Container. Its settings open.
  3. Under Layout, find Direction. Tap the right button.

Add the choice

  1. Open the menu of Container.

    • Phone or tablet: In the Elements list, tap the three dots button next to Container.
    • Desktop: In the Elements list, right-click Container.
  2. Scroll down the menu. Tap Container (Repeated Choice Item).

    The menu of the Container on a phone, scrolled down. Container (Repeated Choice Item) is marked. The menu of the Container on desktop, scrolled down. Container (Repeated Choice Item) is marked.
  3. Open the menu of Container (Repeated Choice Item). Scroll down, and tap Text (Choice Content).

    The menu of Container (Repeated Choice Item) on a phone, scrolled down. Text (Choice Content) is marked. The menu of Container (Repeated Choice Item) on desktop, scrolled down. Text (Choice Content) is marked.

The canvas shows 2 sample choices in a column, at the top middle.

The My Choices layout on a phone. The Elements list shows Container, with Container (Repeated Choice Item) inside it, and Text (Choice Content) inside that. The list is marked. At the top middle of the canvas, Choice 1 and Choice 2 stand in a column, marked. The My Choices layout on desktop. The Elements list shows Container, with Container (Repeated Choice Item) inside it, and Text (Choice Content) inside that. The list is marked. At the top middle of the canvas, Choice 1 and Choice 2 stand in a column, marked.

Test it in Preview

  1. At the top, tap Preview.
  2. Under Number of Choices, choose how many choices to show, from 1 to 6.
  3. Under each Choice content text, type the words of a choice, such as Go to the beach and Stay at home.
The Preview tab of the My Choices layout on a phone. Go to the beach and Stay at home are typed under Choice content text. The canvas shows both choices in a column. The Preview tab, the 2 fields, and the choices on the canvas are marked. The Preview tab of the My Choices layout on desktop. Go to the beach and Stay at home are typed under Choice content text. The canvas shows both choices in a column. The Preview tab, the 2 fields, and the choices on the canvas are marked.

Special elements

Element What it does
Container (Repeated Choice Item) Repeats once for each choice. Put it in a container whose Direction makes a column or a row.
Container (Single Choice Item) Shows one choice. Under Choice in its settings, choose which one, such as Choice 1. It hides when the action has fewer choices. Use it to place each choice by hand.
Text (Choice Content) Shows the words of the choice. Add it inside one of the 2 containers above.

A tap on a choice container picks that choice. To make the words inside react when the reader points at a choice, use Child Interaction. See Container.

Next steps