Storyfall

HTML Export

Export your story as a self-contained HTML file that plays in any modern web browser. The story logic, layout, and saved progress all live in the file. Hosted audio still needs network access.

Features

The exported HTML file includes everything needed for a complete reading experience:

  • Full story playback with scenes, choices, variables, conditions, and effects. The exported file uses the same Storyfall game engine as single-player web play.
  • Player name collection when your story asks readers for a name before play.
  • Text variations from the editor, including random, random once, cycle, and named cycle text.
  • Dark mode with a built-in toggle for reader preference.
  • Save and resume using the browser’s localStorage.
  • Variable notifications displayed as toast messages when values change.
  • Sound effects from play_sound effects when the exported file can reach the hosted audio URL.
  • Mobile-friendly responsive layout that works on phones, tablets, and desktops.
  • No app dependency - a single .html file with embedded story logic and UI.

How to Export

  1. Open the Export tab in Story Settings, or click the ellipsis on a story row in the Workshop.
  2. Click “Export as HTML”.

Story Settings Export tab showing JSON and playable HTML export options

Export HTML button in loading state after clicking to start the download

Workshop story row menu with Export playable HTML action

The export uses your current draft content, so make sure your latest edits are saved before exporting.

The game engine is embedded in the exported file. Existing downloaded HTML files do not update automatically when Storyfall’s engine changes, so re-export after important story edits or platform updates.

Characters

If your story uses Characters, the exported file includes them. Readers see your character selection screen with each character’s name, avatar, and description, exactly as they would on storyfall.com.

When a reader picks a character, the exported player applies that character’s variable defaults, NPC sentiments, faction sentiments, and starting scene before rendering the first scene. Scene and choice character restrictions filter against the selected character. The Set Character effect works mid-story too: it applies the new character’s defaults and routes to that character’s starting scene if one is set.

If Hide Character Selection is enabled and your story has exactly one character, the exported file auto-selects it without showing the screen. With more than one character and Hide Character Selection on, no character is assigned automatically and persona-restricted content stays hidden until something selects a character.

Paid characters are filtered at export time. The HTML file you give to a reader only contains the characters they had access to when they downloaded it (free characters always, paid characters they had purchased through Storyfall). Scene-level and choice-level content gated to paid characters they don’t own is stripped from the file rather than just hidden. Inline text conditions and conditional blocks inside an unrestricted scene are still stored in that scene and hidden at runtime, so don’t put paid-only secrets in an unrestricted scene.

Player Names and Variations

Collect Player Name is on by default. When it is enabled in the Variables panel, the exported file asks the reader for their name before the first scene. The exported player uses your Default Name as the suggested value and checks the Disallowed Names list from Game Settings before starting.

If Collect Player Name is off, the exported file uses your Fallback Name for {playerName}.

Text variations created from the variable menu work in exported files. Random text stays stable during a scene visit but is picked again for a new playthrough, cycle text advances when the reader returns to the scene, and random once text stays fixed for the current exported playthrough.

Language Support

The exported HTML file sets the correct <html lang> attribute based on your story’s primary language. For example, a story written in Spanish will have <html lang="es">.

Translations are not currently embedded in the HTML export. The exported file uses the primary language content only.

Limitations

The HTML export is a static snapshot of your story. Some Storyfall features aren’t included:

  • No multiplayer - vote-based and cooperative multiplayer require playing on storyfall.com.
  • No analytics - play statistics aren’t tracked.
  • No bundled audio - background music, narration, and audio files themselves aren’t embedded. Sound effects can play only when the exported file can reach their hosted audio URLs.
  • No translations - only the primary language content is included.
  • Static snapshot - the export reflects your story at the time of export and doesn’t update if you edit the story later.

For the full interactive experience with all features, publish your story on Storyfall instead.

JSON Backup

In addition to HTML export, you can export your story as a JSON file from the same Export tab. The JSON format is useful for:

  • Backup - keep a complete copy of your story data.
  • Transfer - move a story between Storyfall accounts using the import feature.
  • Archival - preserve your work in a structured, machine-readable format.

Next Steps