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.

Story Listing

When you access Twine, either online or through the downloaded app, you will first see your Story Listing. 

This view will show all of your saved story drafts on the left and provide you with options to create a new story, edit settings, and access online documentation on the right. 

Through the right-hand menu, you can:

  • + Story: Create a new story.
  • Import from File: Load a Twine file you created elsewhere to edit on this computer / browser.
  • Archive: Create an archived file of your stories for download. This is an important step if you will be working on multiple computers and will need the file to import elsewhere.
  • Formats: Change default format settings for your stories.
  • Language: Change the language settings for Twine.
  • Help: Redirects you to the online documentation for Twine.
  • Sun and Moon icons: Allows you to select light or dark interfaces for Twine. This tutorial uses the light mode.

To access the Passages View below, select either "+ Story" for a new story or select one of the left-hand drafts to pick up where you left off.

Passages View

When you select existing or new story options from the Story Listing, you will be directed to the Passages View. The gridded top section will eventually display your Story Map visualization. You will work primarily in the Story Listing while working on your story. 

The bottom menu is broken into left and right sides. On the left side, you'll see a home icon and your story title with a triangle indicating a popup menu.

The home button takes you back to your Story Listing.

The title button will open a new menu with the following options: Edit Story JavaScript, Edit Story Stylesheet, Change Story Format, Rename Story, Select All Passages, Snap to Grid, Story Statistics, View Proofing Copy, and Publish to File. The top three options are advanced features and will not be covered here. To learn more about these options, please visit the Twine online documentation.

  • Rename Story: Renames story. This is the name of the file you will ultimately publish. Changing the name of the file after it's downloaded can break the story, so use this option for any changes you'd like before you publish the story.
  • Select All Passages: Selects all passages.
  • Snap to Grid: Snaps all Story Map passages to the grid.
  • Story Statistics: Shows statistics like number of words, characters, passages, links, and broken links for the full story.
  • View Proofing Copy: Produces an easily printed copy of your text for proofreading. 
  • Publish Story: Downloads a version of your story that you cannot edit. If you would like to make changes to your story after publishing it, you will need to publish it again after the changes are complete.


On the right side of the menu you can:




  • Quick Find: Find keywords throughout your story.
  • Find and replace:  Find and replace words throughout your story.
  • Three Passages View Icons: Each icon changes how much information your Story Map shows for each passage.
  • Test: Test your story to look for errors and debug any problems.
  • Play: Play your story to see how the current version will look to readers.
  • + Passage: Add a new, untitled passage to your Story Map.