
For novelists in revision
Plot Hole Finder for Your Whole Manuscript
Paste chapters or drop in your manuscript. Get each contradiction with both lines quoted, the chapters they're from, and the smallest fix.
Free to start. No card needed.
Chapter 9Only Ruth and the coroner had seen the note.
Chapter 14Eli quoted the note word for word.
Who knows what · Sure. Smallest fix: show Ruth telling Eli in chapter 12, or let him guess wrong.
What you'll get
The contradictions in your book, with both lines side by side
- Each contradiction it finds, with both lines quoted
- The chapter each line is in, and how sure it is
- The smallest fix, so you change a line, not a chapter
Before and after
Your manuscript in. Every contradiction, with proof.
The Lighthouse Keeper, draft 3, as a Word file: 31 chapters, about 78,000 words.
1. The key Mara threw away · Facts · Sure Chapter 4: "She dropped the brass key through the grate and heard it hit the water." Chapter 19: "Mara turned the brass key in the lighthouse door." Nothing between chapters 4 and 19 gives it back to her. Smallest fix: one line in chapter 11 where Tomas hands her the spare. 2. March becomes June in two days · Timeline · Sure Chapter 2: "It was the first week of March, and the ferry still ran on its winter schedule." Chapter 6, two days later: "The June heat pressed against the glass." Smallest fix: change "June" in chapter 6, or show the months passing.
Both lines side by side, so you can tell a slip from a choice.
Why it works
What is a plot hole, and how do you find one?
A plot hole finder reads your manuscript and flags the places where your story contradicts itself. This one looks only for contradictions and broken setups; for big-picture notes, use the AI book editor. Wikipedia defines a plot hole as an inconsistency that goes against the flow of logic your plot has established. Every finding quotes both lines with their chapters, says how sure it is, and gives the smallest fix, so you can check it against your draft.
It checks five kinds of problem. Facts: the key she threw away is back in her hand. Timeline: March becomes June in two days. Who knows what: a character quotes a note he never saw. World rules: magic without its price. Dropped threads: a setup that never pays off. It leaves pacing, style and taste alone, which keeps the report short enough to act on. Every item is something you can confirm or dismiss by reading two lines.
Mysteries and unreliable narrators get careful handling, because a puzzle is not a mistake. Anything that looks deliberate, from a hidden clue to a lie told in dialogue, gets its own label, Possibly intentional, so it never sits among the slips. Once the fixes are in, keep your facts straight with a story bible built from your chapters, or track a series in the series bible template. Then check the next draft the same way.
What lands in your doc
What's in your plot hole report
- A summary: how much of the book was read, findings by type, and which to fix first
- Each finding with Line A and Line B quoted word for word, with their chapters
- A how-sure label on every finding: Sure, Check this, or Possibly intentional
- The smallest fix for each, naming the one line or chapter you'd need to change
- Threads you opened: setups with no later payoff, quoted with the chapter they start in
- A timeline as written, chapter by chapter, whenever the dates or days disagree
How it works
From manuscript to findings
Drop your manuscript
Drop in your manuscript or paste chapters. Over about 85,000 words? Upload a PDF so River reads every page.
River reads everything
It reads from the first page to the last, keeping track of facts, dates, secrets and rules.
Get your report
Each contradiction lands in your doc with both lines quoted, a how-sure label and a fix.
Fix and follow up
Make the fixes you agree with, then keep going: River can draft fix lines or recheck a chapter.
How to check your own book for plot holes
Plot holes are broken links between cause and effect. K.M. Weiland puts it that way, calling them incomplete or incorrect causes and effects. Many slip in during revision: you move a scene, cut a chapter, or change a character's age, and a line two hundred pages away still remembers the old version. That's why they're hard to spot yourself. You know the story too well to read what's actually on the page, so your memory quietly fills every gap.
To check by hand, keep a running list as you read. Note each character's fixed facts, the day and season in every chapter, who learns what and when, where important objects are, and your world's rules. Then compare each new chapter against the list. River keeps the same kind of list while it reads, and it only reports a finding once it has found both lines again and copied them word for word.
No tool can promise to catch everything. River is strongest on what the text states outright: names, dates, objects, who was in the room, and what a rule allows. Subtler problems, like a choice that doesn't feel earned or a motive that shifts without reason, need human judgment, so keep your beta readers for those. A whole novel is a long read, so you can step away while it works. For new chapters, run the continuity checks in the self-editing checklist as you go.
Questions authors ask
Common questions
What is a plot hole?
A plot hole is a place where a story contradicts itself or breaks its own logic. Wikipedia lists common kinds, including factual errors, impossible events, out-of-character behavior, continuity errors and storylines that never resolve. A character who knows something they were never told is a classic example, and one this finder looks for.
Can the plot hole finder read my whole manuscript?
Yes. River reads the whole file in order, from the first page to the last, before it writes the report in a new doc; your file stays as it is. The report opens with how much it read and the last line it reached, so you can see it got to the end. If your book is split into parts, drop in up to ten files at once.
How do I find plot holes on my own?
Read for cause and effect, one thread at a time. Follow a single character, object or secret through the book and note every mention with its chapter. Joseph Bates suggests asking whether the events in your novel follow the rules of the story as you set them out. Reading chapters out of order can also break the spell.
Will it flag my mystery or unreliable narrator as mistakes?
It tries not to. A clue you hold back on purpose, a lie a character tells, or a narrator who misleads the reader is labeled Possibly intentional instead of listed as an error. Because both lines are always quoted, you can tell in a moment whether a finding is a real slip or a choice you made.
Does it work for fantasy and science fiction rules?
Yes. World rules are one of the five things it checks, along with facts, timeline, who knows what, and dropped threads. If chapter three says every spell costs the caster a year of life, a free spell in chapter twenty-two gets flagged with both lines quoted, whatever the rule is.
Is my manuscript private?
Yes. Your manuscript goes into your own River space and stays there unless you share it. River's privacy policy says your documents and drafts are not used to train AI models. The report sits in the same space, beside your file, which River reads but never changes.
What can I do after the report?
Keep going in the same space. River offers to draft each fix line in your voice, for you to paste in yourself, or to recheck a chapter once you've revised it. You can also ask where else a character's eye color is mentioned. When the fixes are in, the synopsis generator can turn the same manuscript into a one-page synopsis for agents.
Your next step
More for your book
Catch it before your readers do
Paste chapters or drop in your manuscript. Every finding shows both lines, so you can judge each one yourself.