Creator Docs

History Layout

A History layout shows the past dialogue lines, so the reader can read them again.

The layout has 3 special elements. One of them repeats once for each past line, from the oldest to the newest.

The Preview tab of the My History layout on a phone. The canvas shows 3 past lines in a column, each with its name above it. The Preview tab of the My History layout on desktop. The canvas shows 3 past lines in a column, each with its name above it.

This example makes a simple list of past lines in a new layout called My History.

Create the layout

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

Add a column for the lines

The lines need a container that puts them in a column. Without it, all lines 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.

    The settings of the Container on a phone. Under Layout, the right Direction button is marked. The settings of the Container on desktop. Under Layout, the right Direction button is marked.

Add the history item

  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 (History Item).

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

  4. Open the menu of Container (History Item) again. Scroll down, and tap Text (History Character Name).

A new element goes first in its container. So the name is now above the words.

The canvas shows 3 sample lines in a column.

The My History layout on a phone. The Elements list shows Container, with Container (History Item) inside it, and Text (History Character Name) and Text (History Line Content) inside that. The list is marked. On the canvas, 3 sample lines stand in a column, marked. The My History layout on desktop. The Elements list shows Container, with Container (History Item) inside it, and Text (History Character Name) and Text (History Line Content) inside that. The list is marked. On the canvas, 3 sample lines stand in a column, marked.

Test it in Preview

  1. At the top, tap Preview.
  2. Under Number of History Lines, choose how many lines to show, from 1 to 6.
  3. Under Character name and History line text, type the name and the words of each line.
The Preview tab of the My History layout on a phone. Number of History Lines is 3. The canvas shows 3 sample lines. The first 2 have the names Aki and Mina, and the third has no name. The Preview tab, Number of History Lines, and the lines on the canvas are marked. The Preview tab of the My History layout on desktop. Number of History Lines is 3. The canvas shows 3 sample lines. The first 2 have the names Aki and Mina, and the third has no name. The Preview tab, Number of History Lines, and the lines on the canvas are marked.

The third sample line has no name. Its Text (History Character Name) hides by itself.

Special elements

Element What it does
Container (History Item) Repeats once for each past line. Put it in a container whose Direction makes a column.
Text (History Character Name) Shows the name of the character who spoke the line. It hides on lines that nobody spoke.
Text (History Line Content) Shows the words of the line.

You cannot type words in these texts. Your visual novel fills them in.

Show the history in your visual novel

No action shows a history layout by itself. Add a button to another layout, such as your dialogue box:

  • To open the history, give the button a Push Overlay action with your history layout. See Push Overlay.
  • To close it, give a button in the history layout a Pop Overlay action. See Pop Overlay.

Next steps