Skip to Main Content
It looks like you're using Internet Explorer 11 or older. This website works best with modern browsers such as the latest versions of Chrome, Firefox, Safari, and Edge. If you continue with this browser, you may see unexpected results.

Hyperlinked Stories with Twine

This guide introduces Twine as a lightweight and open-source tool to craft your own hyperlinked stories and games.

Adding Links as Passage Titles

Once you have multiple passages, you can start to create links between them. Remember, links are the movement between passages, so keeping track of which passages you want to link from and link to is important to keep your stories organized!  Before you start to link passages, though, make sure you have given each passage a unique title so you can find it easily when creating the link (See Adding and Editing Passages under Creating a Basic Twine Story).

Starting from the Passages View, double-click or select the edit pencil for the passage you would like to link from. This will open an passages window as seen here. If you want to create a link that uses the exact language of the passage title you are linking to, merely type the title within two double brackets: [[example title]]

You might notice after you type the left brackets "[[" and the first letter of the title, a drop down menu appears with possible passage options. Select the passage title you want to link to and press enter. The link will autocomplete with the correct title and encasing brackets. For example, the story to the left is starting with three links - each leading to a different passage that changes the course of the story. You'll see that the titles in the brackets match the passage titles available in the drop-down menu.



When you return to the Passages View, you'll see that the passage we were linking from now has three arrows connecting it to the three possible passages based on the reader's selection. 

When you select Play, you'll see that the links are blue and now recognizable as hyperlinks for your reader to select.

You will repeat this process for every passage you are linking from. Each passage can link to as many other passages as needed. Don't feel like your story must always move forward among discrete passage paths. In some stories, authors will link back to earlier passages to present the reader with a set of options they already confronted.

Adding Links as New Text

If you don't want the link to use the exact language of the title you are linking to, you can use the same double brackets as above, but specify the text you want to appear as the hyperlink first. You follow this text with a dash and right angle bracket to create an arrow and then type in the title of the passage you want to link to. For example: [[The text that appears->example title]]

In the example to the left, you'll see that the brackets include both the text that will appear and the title of the passage the link is taking you to.

When you select Play now, you'll see that only the first part in the brackets is visible. 

Saving Your Work

Your work automatically saves as you make changes, but how it saves depends on whether you are using the online or downloaded version of Twine. There are important considerations about saving and backing up your work, so please see the Saving and Sharing tab before you start to ensure you do not loose any progress.