Docs/Testing & publishing

Reader reviews

Readers can give your book a thumbs up or a thumbs down, with a few words on why. Reviews sit on the listing page, so a reader deciding whether to buy can see how the book landed with other readers. This page covers who can leave a review, what the label next to the percentage means, and what to do when a review needs flagging.

Who can leave one

Only readers who own the book can review it. A reader can leave a book-level review once they own at least one expansion of your book, and an expansion-level review once they own that specific expansion. Reading the reviews takes a signed-in account: an anonymous visitor sees the listing page and the aggregate score, but not the review text. Only signed-in owners see the compose box.

  • Thumbs up: the reader recommends the book. Optional short writeup, up to 2,000 characters.
  • Thumbs down: the reader does not recommend it. Same optional writeup.
Note
You can't review your own book. Readers who own it see the compose box at the top of the reviews section; on your own listing page it's hidden.

Per book, per expansion

Each reader gets one review per target. A target is either the book as a whole (the listing page) or one of its expansions (the expansion's own page). A reader who owns three expansions can leave one book-level review plus one review per expansion they own. Most readers leave a single book-level review. Per-expansion reviews exist for the reader who wants to say which expansion lost them.

  • Book-level: sits at the bottom of the listing page. Counts toward the "X% positive" tile beside the cover.
  • Expansion-level: sits at the bottom of that expansion's own page. Counts toward the expansion's own aggregate tile.

The label next to the percentage

A bare "76% positive" doesn't tell a reader much. The listing page pairs the percentage with a Steam-style label, worded a little more warmly than Steam's. The percentage and the label both need at least five reviews. Below that, the page shows the raw count and a neutral note that there aren't enough reviews yet. A book with two positive reviews out of two showing "100% Overwhelmingly recommended" would mislead more than help.

  • ≥ 95% positive: "Overwhelmingly recommended." Needs at least 5 reviews.
  • 80-94%: "Strongly recommended."
  • 70-79%: "Generally recommended."
  • 40-69%: "Mixed reviews."
  • 20-39%: "Mostly not recommended."
  • < 20% positive: "Not recommended by readers." Needs at least 5 reviews.
  • Fewer than 5 reviews: "Too few reviews yet" with the raw count.

Where reviews appear

Reviews appear mainly on the listing page. Readers reach it from Discover, from a shared link, or from search, and the aggregate sits beside the cover. Once a book has at least five reviews, its card on Discover also shows a compact "X% positive · N reviews" badge. A reader browsing the catalog can see the rating without opening the book. Below five reviews, the card shows no badge.

Flagging a review

Any reader, including you, can flag a review: spam, harassment, off-topic content, or anything else that doesn't belong on a book page. Use the flag icon on the review itself. The reviewer isn't told who flagged them. An admin reads the report, looks at the review in context, and either lets it stand or removes it.

  • How to flag: open the review, click the flag icon, pick a reason from the dropdown, and add a short note if it helps. One flag per reader per review.
  • What happens next: the review stays visible while the flag is open. An admin either dismisses the flag (the review stays) or removes the review (it comes off the page, and its rating no longer counts toward the aggregate).
Note
Writers don't get a special "remove this review" button. A negative review is not a reason to flag it. Critical but on-topic writeups keep the ratings honest. Flag reviews that are abusive or off-topic, and let the rest stand.

Edits and deletes

A reader can edit or delete their own review at any time from the review card. Edits update the aggregate immediately, and deletes remove the review from the count entirely. An edited review carries a small "edited" mark so other readers know it has changed.