Skip to main content
  • legal
  • tenders
  • citations

How to compare two versions of a contract with AI and catch every change (with the page in each)

Mention both versions, ask for the table of differences, and verify each change on its page. Works for renegotiated contracts, tender documents with addenda, thesis drafts and any document that has passed through several hands.

BrainBox Team7 min read
View as Markdown

Comparing two versions of a contract by eye is the job where an expensive mistake slips in most easily: a notice period that went from 30 to 90 days on page 41, one word that turns "may" into "shall". An AI tool does this job well if it meets two conditions: it reads both documents in full, and for every change it tells you which page of each version it sits on.

What does an AI tool need to compare versions without skipping changes?

It has to read both versions completely. The semantic search a normal chat uses retrieves the passages most relevant to a question; for "what changed?" that is not enough, because the change may sit in a clause the search did not consider relevant. The model needs both full texts in front of it, or it has to walk the documents page by page.

It has to cite per version: termination, 30 days' notice in v1 (page 12), 90 days in v2 (page 14). Each half of the difference opens and gets checked on its own.

It has to be able to do both readings: the content reading, which detects that the liability cap went up even if the sentence was rewritten, and the exact-text reading, which detects a moved comma. The first is the model's job; the second is a diff, and the model has to be able to run one.

BrainBox is an AI workspace for documents that answers with citations to the exact page. In a comparison, every difference carries two citations: the page in the previous version and the page in the new one.

How do you compare the two versions, step by step?

  1. Upload both versions to the same Box

    With names that tell them apart: "Contract v1 2023.pdf" and "Contract v2 2025.pdf". They can be in different formats; the signed PDF and the DOCX draft compare the same way.

  2. Mention both with @ in the chat

    Type @ and pick each file. With the mentions, the AI focuses the answer on those two documents and not on the rest of the Box.

  3. Pick the mode by size

    For contracts up to a few dozen pages, Agent mode reads both documents with its tools. For long contracts, turn on Full Context: it hands the whole files to the model, up to around 900,000 tokens.

  4. Ask for a table with a fixed structure

    For example: "Compare @v1 and @v2 clause by clause. Table with: clause, previous text, new text, impact. Cite the page in each version. At the end, list the clauses with no changes."

  5. If you need the exact text, ask for the diff

    In Agent mode: "Run a text diff of the two versions and show me only the lines that change". The code interpreter returns the added and removed lines.

  6. Verify and save

    Open each citation in both versions. Then ask it to save the table as a file in the Box or export the chat to PDF.

What does the comparison look like?

A legal team compares the contract signed in 2023 with the renegotiated version that just arrived:

Compare @Contract v1 2023.pdf and @Contract v2 2025.pdf clause by clause. Table with clause, before, after and impact, with the page in each version. At the end, what did not change.

I found four substantive changes across 38 clauses.

Clausev1 (2023)v2 (2025)Impact
8.1 Liability capUSD 500,0001USD 2,000,0002Quadruples exposure
14.2 Termination30 days' notice390 days' notice4Slower exit
17 Intellectual propertyJoint ownership5Sole ownership by the client6Loss of rights
21.3 JurisdictionBogotá courts7ICC arbitration, Paris8Change of forum

Unchanged: clauses 1 to 7, 9 to 13, 15, 16, 18 to 20 and 22 to 38. Numbering shifts by one from clause 14 onward because v2 adds 14.3.

Footnotes

  1. 1.Contract v1 2023.pdf- p. 9
  2. 2.Contract v2 2025.pdf- p. 10
  3. 3.Contract v1 2023.pdf- p. 12
  4. 4.Contract v2 2025.pdf- p. 14
  5. 5.Contract v1 2023.pdf- p. 16
  6. 6.Contract v2 2025.pdf- p. 18
  7. 7.Contract v1 2023.pdf- p. 21
  8. 8.Contract v2 2025.pdf- p. 23

The "unchanged" list at the end weighs as much as the table: it is what lets you say you reviewed the whole contract and not only what the AI chose to show. Each footnote opens the document at that page, as in any cited answer.

Which mode should you use for which document?

SituationRecommended modeWhy
Contract up to 30 or 40 pagesAgentReads both with its tools and cites by page
Long contract or several annexesFull ContextHands over the full texts, up to ~900,000 tokens; nothing is left out for not being "relevant"
You need the exact text that changedAgent + diff in the code interpreterCompares line by line, without interpretation
Original tender document vs. several addendaAgent, mentioning all of themOne column per version; ideal for tracking how a requirement evolved
Look up one specific term in bothFind TextFinds the exact word and the page in each file

What else is comparing versions with AI good for?

In tenders, the typical case is the original bid document against each addendum: addenda modify requirements you already read, and a change from "3 years of experience" to "5 years" in addendum 3 can disqualify you. With the three versions mentioned, the table shows which requirement changed and in which addendum.

In research, comparing January's thesis draft with March's returns which hypothesis, sample or method changed, so you can answer your advisor without rereading 180 pages.

In procurement and compliance, comparing the current policy with the proposed one produces the list of changes to take to the committee, with the page for each.

How is this different from pasting both texts into ChatGPT?

Two texts pasted into a general chatBrainBox
SizeLimited by what fits in the messageFull Context up to ~900,000 tokens
Scanned PDFsHave to be transcribed firstAutomatic OCR on upload
Citation per versionNo pagesPage in each version for every difference
Exact diffManualCode interpreter in Agent mode
AfterwardsThe comparison is lostSaved as a Box file or exported

Tools like Word have a document compare feature that works well for two DOCX files with the same structure; it does not interpret the impact of a change or compare a scanned PDF with a Word draft.

For legal teams, this is the review before signing any renegotiation; for compliance, it is how you document what changed between two versions of a policy.

BrainBox chat comparing two versions of a contract: the user's message mentions both files with @, the answer shows a table of clauses with the previous and new text, each cell with its numbered citation, and the Footnotes list gives the page in each version

A 120-page contract in two versions fits whole in Full Context mode with room to spare: on the order of 150,000 tokens out of the 900,000 available.

Frequently asked questions

Does the AI compare the exact text or the meaning of the clauses?
Both, depending on what you ask. By default it compares content: it detects that the liability cap went from 500,000 to 2,000,000 even if the wording changed. If you need the exact text (an added word, a moved comma), in Agent mode it can run a text diff in the code interpreter and return the changed lines.
Which formats can I compare?
Anything BrainBox indexes: PDF (including scans, via OCR), Word, PowerPoint, Excel, text and Markdown. The two versions need not share a format: you can compare the signed PDF with the DOCX draft.
What if the contract is 200 pages?
Turn on Full Context mode. It hands the entire content of the selected files to the model (up to around 900,000 tokens) instead of searching for passages, so no change is left out for not being retrieved. It takes longer and costs more intelligence units, but that is what a full review calls for.
How do I know nothing was missed?
Ask it to work by section (clause by clause or annex by annex) and to state explicitly which sections did not change. A list of 'unchanged' is as verifiable as a list of changes. And every difference carries its page in both versions, so checking means opening the two.
Does it work for more than two versions?
Yes. You can mention three or more files and ask for how a clause evolved across versions, or compare the original tender document with each addendum. The resulting table has one column per version.
Can I save the table of differences?
Yes. Ask the assistant to write it as a Markdown file in the Box, or export the chat to PDF, Markdown or HTML. In Agent mode it can also generate a designed Word or PDF document with the table.

Written by

BrainBox Team

Document intelligence, by ExaByte Company

We build BrainBox — the platform teams use to ask questions across their own documents and get answers with exact page citations.