> ## Documentation Index
> Fetch the complete documentation index at: https://help.casaconect.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tracked changes

> How suggestions work in Casa Conect: reviewing the agent's edits, resolving changes in Word files, and how redlines survive the journey to and from Microsoft Word.

Tracked changes are the contract between you and the agent. **The agent proposes, and you decide.** They are also how lawyers already work with each other, so Casa Conect's tracked changes are built to be the *same* changes Word shows. They are not a lookalike that falls apart when the file leaves the platform.

## Where they come from

| Source                                                   | How it appears                                                 |
| :------------------------------------------------------- | :------------------------------------------------------------- |
| **The agent** edits an existing document                 | Suggestions attributed to the agent                            |
| **A Word file** that already contains tracked changes    | Imported as suggestions with their **original authors' names** |
| A **workflow** such as [Anonymize](/workflows/anonymize) | Suggestions, one for each replacement                          |

Text the agent writes into a brand-new document is not tracked, because there is nothing to compare it with. Your own typing in the editor is not tracked either. To exchange redlines with a colleague or the other side, work in Word, where Track Changes is available to everyone.

## Kinds of change

| Change                | In the document                                                                |
| :-------------------- | :----------------------------------------------------------------------------- |
| **Inserted**          | New text, marked as an addition                                                |
| **Deleted**           | Existing text, struck through                                                  |
| **Replaced**          | A deletion and an insertion, linked as one decision                            |
| **Moved**             | Text taken from one place and put in another, linked so that you can follow it |
| **Formatting change** | The same words with different formatting                                       |

## Review in the editor

While suggestions are pending, a review bar shows how many there are.

<Steps>
  <Step title="Read each change in context">
    Select a suggestion to see who made it. Read deletions as carefully as insertions. A removed *"not"* is a small change with a large effect.
  </Step>

  <Step title="Accept or reject">
    Resolve suggestions one at a time, or use **Accept all** or **Reject all** once you have read them.
  </Step>

  <Step title="Carry on">
    Resolving is an ordinary edit. Colleagues see it at once, and it is part of the document's history.
  </Step>
</Steps>

<Warning>
  **Accept all** is convenient, and it is also how an unwanted change gets through. Use it after reading, not instead of reading.
</Warning>

## In the viewer

A Word file with tracked changes shows a **Tracked changes** panel in the [viewer](/documents/vault#the-viewer), so you can resolve changes without converting the file.

* Step through with **Previous change** and **Next change**.
* Each entry shows its type (*Inserted*, *Deleted*, *Moved from here*, *Moved to here* or *Formatting change*) and its author.
* **Accept change** or **Reject change** individually, or use **Accept all** or **Reject all**.
* The result is saved as a **new version**: *"Changes applied — saved as a new version."* The earlier version stays in the history, labelled *Changes resolved*.

Some changes cannot be listed individually: those inside headers, footers, footnotes and pure formatting. The panel tells you how many there are, and **Accept all** and **Reject all** resolve them as well.

If the file changed after you opened it, because a colleague saved a newer version, your action is refused rather than applied to content you have not seen. Reopen the file and review again.

## In Microsoft Word

With the [Word add-in](/word-add-in/overview), the agent's edits are applied to your open document as **native Word tracked changes**. You review them with Word's own *Review* tab, exactly like a colleague's redline. Casa Conect switches Track Changes on while it applies the edits, and restores your previous setting afterwards.

## Across the Word boundary

| Direction                             | What happens                                                                                                                                                               |
| :------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Word to Casa Conect**               | Insertions, deletions, moves and formatting changes become suggestions, with each author's name preserved. After import you are told how many tracked changes came across. |
| **Casa Conect to Word**               | Pending suggestions are written as real Word revisions with their authors and dates. You are told how many tracked changes are included in the file.                       |
| **Agent edits on a stored Word file** | Written into the file as Word tracked changes, in a **new version**. Everything else in the file is left exactly as it was.                                                |

Attribution is kept as *names*. A change made by "María López" in Word is shown as María López's in Casa Conect, and the other way round. Imported authors are not matched to Casa Conect accounts.

A few unusual constructions are simplified. For example, a tracked *move* that cannot be rebuilt exactly becomes a linked deletion and insertion. You are always told when this happens. See [Word documents](/documents/word-documents#what-changes-in-translation).
