Docs/Testing & publishing

Publishing

Publishing puts your book in front of Readers. The first publish puts it in the catalog as Edition 1. After that, new Chapters go out as an Expansion, a part of the book Readers buy separately. What is published stays as it is. A fix to it is made in an Edition, the next copy of your book.

Where to find it

Every book has its own Publish page. You reach it from the sidebar. While an Edition is open, its banner has a Publish Edition button too. The page shows what this publish changes for Readers, where each new Chapter goes, and anything still blocking the publish.

How a publish works

  • Validation runs across the book. Every Chapter, Glossary Item, Dynamic Component, and Trigger is checked. If anything is broken, such as a reference to something deleted or a template missing a required field, the publish button turns off. The failing rows are listed, and selecting one jumps to the fix.
  • Each new Chapter gets a part. A Chapter that was never published has a Part of choice. On a first publish it is Not yet or the original story. After that it is Not yet or, for a Chapter after the last published one, New Expansion, sold separately. Every Chapter starts on Not yet, so a half-written one stays out of the publish until you pick its part.
  • The book is copied as it is right now. What this publish puts out is read from that copy. Chapters left on Not yet stay out of it.
  • It goes live at once. Readers who start your book from then on start on the newest Edition.

What a publish locks

Once a piece of your book is published, the editor locks it, so what Readers have stays as it is. New Chapters, Glossary Items and Dynamic Components stay open, and they go out with your next Expansion.

  • Chapters lock entirely. You can't rename them, retag them, change the toggles, edit a paragraph, or delete them.
  • Glossary Items take additions only. Their published blocks and Facts stay as they are, with the title, description, category and the combat and trade settings. New blocks at the bottom and new Facts stay editable, and they go out with your next Expansion.
  • Dynamic Components lock fully. Their cards show a lock and no longer open. A card's Duplicate makes a copy with (Copy) added to the name, and the copy is yours to edit.
What stays editable
A Glossary Item's Card Settings and Player Toolbar Settings, the framing of the cover and the book's look under Book Settings stay editable. You can add new Tags, and the Tags a Glossary Item was published with stay.
Your store page changes at once
The title, the descriptions and the Expansion names change on your store page as soon as you save them under Book Settings. A published book's covers change under Manage covers on your Published page, also at once.

A locked piece changes in an Edition.

Editions

An Edition is your book as Readers have it. Edition 1 is your first publish. A fix to a published part, such as a typo or a rule that stops the story, goes into the next Edition. Editions are free. A Reader who owns a part of your book gets each new Edition of it without paying again.

  • Start working on an Edition is in the Published book settings menu on the book's card, on your Published page and your dashboard. A banner then stays at the top of the editor until the Edition is published or discarded. Until then the book can't be marked complete or get a new Expansion.
  • One part at a time, the original story first. The part the Edition is on opens in the editor, with its published Chapters, Glossary Items and Dynamic Components. Work on another part is in the banner, with Switch beside it. The part you switch to opens, and the one you were on locks again. What you changed there stays in the Edition and goes out with it.
  • A rename can break a rule in another part that still uses the old name. The Publish page tells you when it finds one. The Edition can be published once that rule is changed in its own part, or once the old name is back.
  • Drafts wait. What you wrote for the next Expansion before the Edition started is locked until the Edition is published or discarded.
  • A Chapter written in an Edition goes at the end of the part the Edition is on, and joins that part. Everyone who owns the part gets the Chapter with the Edition, at no charge. An Edition can't start a new Expansion.
A new Chapter can land before older ones

For example, a book's original story holds a Prologue, and Expansion 2 holds Chapter 1. An Edition starts on the original story. A Chapter added there goes right after the Prologue, so Readers reach it before Chapter 1. Naming it Chapter 2 doesn't move it.

In that Chapter, a Trigger set to Only when... can't check Chapter 1. A condition only looks at what Readers have already read, and they haven't reached Chapter 1 yet. A Trigger's changes still reach Chapter 1, in either mode, because changes act on what lies ahead.

Chapter 2 of the next Expansion is written once the Edition is published or discarded. Chapter 2 of Expansion 2 is added after Work on another part has moved the Edition there. A Chapter in the wrong part can be deleted while the Edition is open. Once the Edition is published, that Chapter stays in the original story.

  • A note for your Readers. The Publish page asks for one, up to 300 characters. It shows in their notice and on your book's page. The page also asks whether the Edition is Corrections or an Important fix.
  • Discard this Edition puts every published part back as it was when the Edition started. Everything written in the Edition goes, new Chapters included. Your drafts for the next Expansion stay. A discard can't be undone.
  • The last 10 Editions are kept. Readers can switch to any of them that has every part they own. One book can have up to 10 Editions in any 24 hours.

Readers in the middle of your book

Someone who starts your book starts on the newest Edition. Someone already reading stays on the Edition they are reading until they choose to switch.

  • They're told when they next open the book. Corrections shows a note at the top of the page. An Important fix asks in a window. For a part where it changed only the look (the theme, the pictures, an Item's cover), its Readers get the note at the top instead. Your note for Readers comes with either.
  • A switch that keeps their place. When the new Edition changes only words and pictures already there, or only Chapters after the furthest one they reached, switching keeps their place and their choices. Adding something new keeps it too: a new Glossary Item or Calculation, or a new Fact, Tag or Header on a Glossary Item.
  • A switch that means starting over. When it changes a Chapter up to the furthest one they reached, switching to the new Edition means starting over from the first Chapter. So does a change to something that reaches the whole story, such as a Fact's Starting value, a Calculation or a Chapter's Hide by default switch.
  • Any of the last 10 Editions. Readers switch to one from the Editions icon in the book, among those with every part they own. A Reader who picks an older Edition hears only of an Important fix after that.
  • A new part waits for them too. A Reader who buys or gets the next Expansion stays where they are. When they next open the book, a note at the top says it is in their library, with a button to read it. Reading it means switching to the newest Edition, by the rules above. When their read is on an older Edition, a line by the buy button says so first.

Expansions

Expansions stack. A Reader who buys Expansion 2 must already own the original story. Expansion 3 needs both, and so on. Readers can't skip ahead.

  • The original story is your first publish. This is the part new Readers start with.
  • Expansion 2 and beyond add new Chapters after the last published one. Their part is New Expansion, and the last step of the Publish page asks the Expansion's name, cover, descriptions and price. A new Expansion joins the newest Edition. It doesn't make an Edition of its own.
  • A Chapter's part is for good. It is set when the Chapter is first published. A Chapter joins a part that's already out only in an Edition.
  • Every part that's out stays whole. At every Edition it keeps at least one Chapter and meets the writing floor below. Readers bought it as a part of its own.
Note
Each publish has four caps. One publish can add up to 40 new Chapters and 50 new Glossary Items. It can add new blocks to 30 already-published Glossary Items, with no more than 200 new blocks on any one of those. That fourth cap is the one a serial novelist meets first, by pouring a long lore update into one character who was published a while ago. If you hit one, the Publish page says so.

Marking a story complete

A book is an open-ended stack of Expansions, so Readers can't tell a finished story from one that's still going. When the last Expansion is out, Mark complete in the Published book settings menu shows Readers a Complete badge wherever the book is listed: the catalog, Discover, your author profile, and the store page.

  • A Complete book is read-only. It can't start an Edition or a new Expansion. Selecting its card says how to reopen it.
  • Reopen, in the same menu, takes the badge away and opens the book for writing again.
  • While an Edition is open, the book can't be marked complete. It can be once the Edition is published or discarded.

What stays fixed

A few things stay as they are once they're published, even in an Edition. Readers' reads depend on them.

  • A Character Readers play as stays Playable and keeps its category, and it can't be deleted. Readers have started the book as them.
  • A published book can't be deleted. Readers own it.
  • A Chapter's part. The original story or the Expansion it was published in.

Pricing

  • Price per Expansion. You set it on the Publish page. Verhaler is the seller of record. A Reader who pays in your currency pays exactly the price you set. A Reader who pays in another currency pays it converted and rounded up to the next .99. Any VAT or sales tax is included in that price, not added on top, and we handle it.
  • A paid price needs payouts set up. To charge anything above zero you need a connected Stripe payout account that has finished onboarding. Until then the price field is locked to Free.

What can block a publish

The Publish page says why the publish button is off. The usual reasons:

  • Broken references. An invalid Dynamic Component, an invalid Trigger, or a Trigger result pointing at a Chapter or Glossary Item that has since been deleted.
  • Not enough writing yet. Every Expansion, paid or free, needs at least 30 paragraphs and 15,000 characters of its own writing. Publishing costs nothing, so this floor keeps the catalog honest.
  • Nothing to publish. Outside an Edition, a publish needs a Chapter set to the original story or to a new Expansion. In an Edition, something published has to have changed since the last Edition.
  • Missing payout setup for paid Expansions: a connected Stripe payout account and an eligible writer country.
  • Per-publish caps hit. This publish adds more than 40 new Chapters or 50 new Glossary Items. Or it adds to more than 30 already-published Glossary Items, or puts more than 200 new blocks on any one of them. The page names the Glossary Items that went over, up to three of them.