Guide

How to Export Your Story
to Twine

Take any story you've written on StoryQuestor into Twine 2, the open-source tool for interactive fiction, in a few clicks.

Why Export

Your Story, in a Format You Can Take Anywhere

Twine is one of the most widely used tools for interactive fiction, and its files are a common format for branching stories. Exporting gives you a copy of your story you can keep, edit in Twine, add Twine-specific code to, or publish on sites that accept Twine games, such as itch.io.

Exporting doesn't change anything on StoryQuestor. Your story stays exactly where it is, and you can export again whenever you make changes.

Twine export is included with the Weekly and Monthly plans. See plans.

Step by Step

Exporting and Importing

  1. 1

    Open your story in the editor

    From your dashboard, open the story you want to export.

  2. 2

    Open Story Settings

    Click Settings in the editor toolbar.

  3. 3

    Download the Twine file

    Under "Export to Twine", click Download Twine file. You'll get a single .html file named after your story.

  4. 4

    Import it into Twine

    In Twine 2 (desktop or twinery.org), choose Library → Import, pick the downloaded file, and your story appears in your library.

What Carries Over

How Your Story Maps to Twine

Scenes become passages

Each scene's title becomes the passage name and its text becomes the passage body. Your start scene is set as Twine's starting passage.

Choices become links

Every choice is written as a Harlowe link to the scene it leads to, in the same order readers see them. Chapter endings link on to the next chapter.

Chapters become tags

Scenes inside a chapter are tagged with the chapter name, so you can filter and highlight them in Twine.

Scene images come along

Scene images are included as image links pointing at their StoryQuestor URLs. They're linked, not embedded, so they need an internet connection to show.

Your map layout is kept

Node Graph stories keep their canvas arrangement in Twine's story map. Block Builder and Storybook stories are laid out in a tidy grid.

Good to Know

What Isn't Included

The export covers your story's text and structure. World Builder features such as character stats, choice effects and conditions, items, foes and combat aren't included, and neither are scene soundscapes. In Twine, choices that depended on a condition show up as ordinary links.

Passages use Harlowe, Twine's default story format. If two scenes share a title, the second gets a number added, like “The Cave (2)”, because Twine needs every passage name to be unique. Brackets and arrows in titles are swapped for similar characters so they don't break Twine's link syntax.

Storybook stories export as a run of pages, each with a “Next page” link to the next.

Write it visually, take it anywhere

Build your branching story on StoryQuestor's canvas, then export it to Twine whenever you like.