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
Open your story in the editor
From your dashboard, open the story you want to export.
- 2
Open Story Settings
Click Settings in the editor toolbar.
- 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
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.
Continue the Series
What Is Interactive Fiction?
An introduction to the medium, including where Twine fits in.
Read more GuideBranching Story Structure Explained
The structural patterns almost every branching story is built from.
Read more GuideHow to Write Branching Stories
A step-by-step approach to planning and drafting a branching story.
Read more ResourcesInteractive Fiction History
From text adventures to Twine and beyond.
Read moreWrite it visually, take it anywhere
Build your branching story on StoryQuestor's canvas, then export it to Twine whenever you like.