Skip to content
Back to Help Center

For writers

Everything from your first node to your first payout. Still stuck? Email support@boughly.com.

Getting started

How do I become a writer?

Every Boughly account starts as a reader. Writing is a free, one-time activation — it unlocks the creator dashboard and the story editor without changing anything about your reading account.

Open Settings → Writing and click Become a writer. You can also reach it from the avatar menu (top-right) or the quick links on your Home page. You'll land on your Dashboard ready to start your first story.

How do I start a story?

Sign in, open your Dashboard, and click "New story." You can start blank or pick a template — branching prompts and short-form starters live there.

What's a story vs. a book?

A story is one self-contained branching narrative. A book groups multiple stories into a series — useful for episodic releases or volumes. Both publish from the editor; books have their own publish flow that bundles their stories.

What does the dashboard show me?
  • Dashboard home — your stories and books.
  • Analytics — reads, completion rates, choice splits per node.
  • Earnings — gross unlocks, platform share, payable balance.
  • Connect — link a Stripe account so you can be paid.
  • Content — review and manage all stories you've created.
  • Templates — starting points.
  • Settings — display name, payout email, notification preferences.

Editor how-tos

How do I branch quickly?

Two fast ways to grow the story from where you are:

  • Drag to create. Grab the handle on a scene's edge and drag it out to empty canvas. When you let go, Boughly makes a new scene already linked to the one you dragged from.
  • Branch while you write. With your cursor in a scene's text, press Ctrl+Enter (or Cmd+Enter). A little "What does the reader choose?" prompt pops up at your cursor — type the choice label, hit Enter, and Boughly adds the choice plus a fresh linked scene and drops you into it to keep writing.
How do choices and logic work — do I need to write code?

No code. Conditions and mutations read as plain sentences — "Show this choice only if Trust is at least 3" or "Add 1 to Trust when the reader picks this." You build them from dropdowns in the Inspector, and you can create a new variable right there inline when you need one.

A gated choice is one with a condition attached. You decide what happens when the condition isn't met: the choice can be hidden (the reader never sees it) or shown grayed out (visible but not selectable, hinting there was another way through). Pick whichever fits the moment.

How do I organize scenes into chapters?
  • Group. Select the scenes you want together, then press Ctrl+G to wrap them in a chapter frame.
  • Collapse one chapter. Double-click a chapter's header to fold it down to a single capsule, so a finished section stops taking up space.
  • See the whole outline. Use Collapse All in the top bar (graph view) to fold every chapter into capsules for a table-of-contents view of the story; the same button expands them again.
  • Re-chapter. Drag a scene into a different chapter's frame to move it there.
How do I find my way around a big story?
  • Zoom out for the map. As you zoom out, scenes simplify automatically — full cards become pills, then dots — so the overall shape of a large story stays readable.
  • Highlight connections on hover. Hover a scene to dim everything except it and its direct connections. If you find that distracting, turn it off with the "Hover to highlight connections" toggle in the canvas view options — trace and filter still work either way.
  • Trace routes. Select a scene and press T to light up the paths that reach it from the start (press Shift+T to trace everything downstream from it instead). Press the key again or hit Esc to clear.
  • Filter scenes. Press Ctrl+F to open the filter bar. Type plain text to match titles and prose, or use tokens like type:ending, is:gated, and tag:canon to narrow the canvas.
  • Jump to a scene. Press Ctrl+K to search your scenes by title and jump straight to one.
Can I edit lots of scenes at once?

Yes. Select several scenes — drag a marquee box around them, or Shift-click to add scenes one at a time — and the bulk action bar appears with word count, set-type, tag, and delete controls for the whole selection.

  • Select connected scenes. Right-click a scene and choose Select all downstream (everything reachable from it) or Select all upstream (everything that can reach it).
  • Context menus. Right-click a scene, an edge, or empty canvas for the actions that make sense there.
  • Duplicate. Select a scene and press Ctrl+D to copy it.
How does version history keep my work safe?
  • Autosave. Your work saves continuously as you write — the save indicator in the top bar shows the current state.
  • Named checkpoints. Press Ctrl+Shift+S to save a named snapshot you can find and return to later.
  • Automatic snapshots. Boughly also snapshots before risky actions, so a big change is always recoverable.
  • Restore. Open Version History to restore a whole story to an earlier snapshot — or restore just a single scene without rolling back everything else. Restoring adds a new version on top; nothing is destroyed.
How do I preview my story before publishing?

Open Preview to play your story with your real conditions and mutations live. A few things it can do:

  • Play from any scene. Jump into the story at a specific scene instead of always starting from the beginning — handy for testing a branch deep in the tree.
  • See the paywall. Toggle the 0 coins reader view to see exactly what a reader with no coins sees and where your paywall falls (display only — no charge).
  • Check mobile. Toggle the Phone frame to constrain the preview to a phone-width column and check your line lengths.
Can I write on a tablet or phone?

The editor works on a tablet. The branching graph needs room, so on a phone you get a quick-capture screen instead: jot an idea and it's saved to your story's Binder, waiting for you the next time you open the story on a bigger screen. The reader preview stays fully usable on a phone.

Publishing & money

How do content ratings work?

Every story is rated General, Teen (13+), or Mature (18+). The rating is set at publish time and gates discovery — Mature content is hidden from minors. The full definitions and what each tier allows are in Terms of Service §5 and the Mature tier definition. On-page explicit sexual content is not permitted at any rating; "fade to black" is the ceiling.

Will my story appear in the Boughly mobile app?

General and Teen stories appear in the Boughly mobile app and on the web. Mature (18+) stories are web-only — app store content policies don't allow them in the app, so they are never shown in the app's catalog. Readers on iOS or Android who open a link to a Mature story are directed to read it on boughly.com instead. You'll see a notice in the publish flow whenever your self-assessment computes a Mature rating.

Free vs. paid — how do I price?

At publish time you choose Free or set a coin price. Paid stories require Stripe Connect to be onboarded (see Connect). Pricing can be changed after publish, but unlocks already purchased stay accessible to the reader.

How do I charge for my story?

There are two ways to monetize, and which one you want depends on whether you're charging for one story or a series of chapters.

A single story → set a coin price + a paywall node. In the story editor, open Publish and choose Paid, then pick a coin price (100 coins = $1.00). Readers sample your story for free up to the paywall node — the node you mark as the cut-off — and spend coins once to unlock everything past it. Mark the paywall on a node from its settings in the editor ("Paywall Gate"). One unlock buys the whole rest of that story.

Chapter-by-chapter → publish a Book. If you want a free intro and then paid chapters (or every chapter paid, or the latest few free), create a Book from your Dashboard and add your stories to it as chapters. A Book's Pricing & Access panel gives you the chapter-aware modes:

  • Whole book — one unlock buys every chapter.
  • First N chapters free — hook readers, then charge.
  • Latest N free — back catalog paid, newest chapters free.
  • Per chapter — each chapter unlocks individually.

Either way, payouts come from paid coin spends only and pay out monthly via Stripe once you clear the threshold. See Creator Payouts for the full split and fee math.

How do I publish, and how do I set the free/paid line?

Open Publish from the editor top bar and step through the flow: story details (blurb, cover, rating), access (free or a coin price), and a final review. Publish is blocked while any error-level diagnostic is unresolved, so clear the Diagnostics panel first.

For a paid story with chapters, the access step shows a chapter ladder. Drag the free line between chapters to set where free reading stops and paid begins — the free line marks the entry of the first paid chapter. As you move it, the reader's receipt updates to estimate what a reader samples for free and what they pay to unlock the rest. The manual paywall picker on a scene stays in sync with the ladder — both set the same paywall.

What does the blurb / cover do?

The blurb is your short pitch shown on cards and the story landing page. The cover image is what readers see in shelves and search. Both are required to publish; the cover should be portrait-oriented and around 1200×1800 px or larger.

How do payouts work?

You earn a flat 70% of the face value of every eligible paid coin spent on your stories — and on tips, which use the same calculation. Boughly keeps 30% and pays payment-processing and payout costs from it. The split is computed automatically.

  • Monthly payouts into the Stripe Connect account you onboarded.
  • $10 minimum — below it, your balance rolls into the next month.
  • Your first three payouts are capped at $200 each (anti-fraud on new creators); the remainder carries over, and later payouts are uncapped.
  • If a buyer refunds or charges back a bundle, the matching creator earnings are proportionally reversed — you are paid only on coins that stay paid.

Full split and fee math is on the Creator Payouts page. Questions about a specific payout — email support@boughly.com from your account address with the payout ID.

Can I unpublish or take down a story?

Yes, from the editor or from Content. Readers who already unlocked the story retain access per Section 8 of the Terms of Service. Copyright takedowns follow the DMCA Policy.

Reader feedback

How do I see reader comments?

Open a story in the editor and use the Comments panel. Each comment is pinned to the node it was left on, so you can see exactly where readers reacted. The Comments inbox at the dashboard level aggregates unresolved comments across your work.

What are reader suggestions?

Readers can suggest small edits (typos, line-level fixes) on your published prose. Suggestions come into the editor as proposals — you accept, reject, or modify, just like a pull request.

Can I roll back to an earlier version?

Yes. The Version History panel in the editor keeps named snapshots of your story. You can diff two versions and restore any of them. Restoring creates a new version on top — nothing is destroyed.

How the editor works

A tour of every panel and concept in the story editor. Skim the headings, jump to what you need.

The canvas

The editor opens to a 2D canvas. Each box is a node (a scene); each line between boxes is an edge (a choice). Pan with click-and-drag on empty space, zoom with the mouse wheel or trackpad, and use the minimap or node search to jump around large stories.

The left rail holds your panels (Binder, Cast, Wiki, Research, Variables, Diagnostics). The right rail is the Inspector for whatever node or edge is selected. The top bar has Preview, Publish, Save indicator, and the View switcher.

Nodes

A node is one beat of the story — a scene, a passage, a moment. Click a node to open it; its prose body is edited with a rich-text editor (bold, italic, links, headings, image embeds). The Inspector on the right shows the node's metadata: title, summary, tags, the characters present, the variables it mutates, and the choices that lead out.

Node types. By default you have scene and ending. You can define custom node types in the Node Type Manager (e.g., flashback, cutscene, recap) — these are mostly organizational, but custom types can carry default tags and a color so the canvas stays readable.

Search. Press Ctrl/Cmd+K to open Node Search and jump to any node by title.

Choices (edges)

Drag from a node's bottom handle to another node to create a choice. Each edge has a label (what the reader sees as the choice button), an optional condition (when the choice should be visible), and an optional mutation (what changes when the reader takes it).

Order matters. Choices render in the order they appear in the Inspector. Drag to reorder.

Fallback rules. If every outgoing edge from a node is blocked by unsatisfied conditions, the editor will warn you. You can set a fallback so the reader is never stranded — see the Fallback Rule editor on each node.

Variables, conditions, and mutations

Variables are story-wide state — booleans, numbers, or strings the reader's path accumulates. Define them in the Variables panel (e.g., has_key: boolean, trust_level: number).

Conditions gate edges or whole nodes: has_key == true, trust_level >= 3. If the condition fails, the reader doesn't see the choice (or the node, if it's gated at the node level).

Mutations change variables when traversed: set has_key = true, add trust_level + 1. Mutations on a choice fire when the reader picks it. Mutations on a node fire when the reader arrives at the node.

The Diagnostics panel flags variables that are read but never written (typos), or written but never read (dead code).

Cast and characters

The Cast panel is your character roster. Each character has a sheet — appearance, voice, relationships, notes. Tag nodes with the characters present in them and the Relationship Graph will visualize who-meets-whom across the story.

Character sheets are private notes — readers never see them. They're for keeping your continuity straight in long branching work.

Wiki and research

The Wiki is private worldbuilding notes attached to the story — locations, lore, magic systems. The Research panel holds reference material: URLs, images, quotes. You can pin research items to the strip at the bottom of the canvas so they're one click away while you write.

Endings and paths

Mark a node as an ending via its type. The Ending Matrix gives you a table of every reachable ending plus the variable state that gets there — useful for sanity-checking a multi-ending story before publish.

Preview

Preview mode plays your story as a reader would, with your real conditions and mutations live. It's the single best diagnostic you have — most pathing bugs surface in 30 seconds of clicking through. Preview state isn't saved to your reader account.

Diagnostics

The Diagnostics panel is the editor's health check. It surfaces:

  • Orphan nodes — unreachable from the start node.
  • Dead ends — non-ending nodes with no outgoing edges.
  • Unreachable endings — endings no path can satisfy.
  • Empty conditions / mutations — fields left blank.
  • Variable typos — references to undeclared variables.

Publish blocks if any error-level diagnostic is unresolved.

Keyboard shortcuts

Press ? in the editor to open the shortcuts overlay. Highlights:

  • Cmd/Ctrl + K — Node search
  • Cmd/Ctrl + S — Force save (autosave is on)
  • Cmd/Ctrl + Z / Shift + Cmd/Ctrl + Z — Undo / Redo
  • Delete — Remove selected node or edge

Going further

Read the Community Guidelines before you publish, especially the Mature definition. For payouts and tax, the Creator Payouts page is the source of truth. Bugs or feature ideas — email support@boughly.com and we'll route it.