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. An Expansion-level review needs that specific Expansion. Anyone who opens the listing page reads every review in full, with the score, signed in or not. So an undecided shopper sees what other Readers think, and so does a stranger following your share link. Writing a review needs an account. A signed-out visitor gets an invitation to sign in and read the book where the compose box would be.

  • Thumbs up: the Reader recommends the book. Optional writeup, up to 8,000 characters. It can be left empty, but it cannot be nearly empty. A writeup with anything in it needs at least 15 visible 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 badge. The badge holds the verdict label and the bare count, as in "Strongly recommended · 12". The percentage is on the listing page, not on the card. 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. The flag icon is 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: the flag icon opens a short form. It asks for a reason from a dropdown, and 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.