# Microsoft Word add-in: approved documents in Word

Source: https://versodocs.com/docs/word

Work in Word, keep approvals in VersoDocs. The add-in opens the **Current** version of a document in Word, keeps the file linked to it, tells you when a newer version is approved, and sends your edits back as a **proposal** that goes through normal review. (All plans · proposing: Pro)

## Plans

|   | Free | Team | Pro |
| --- | --- | --- | --- |
| Word + Google Docs add-ins (search, open Current, link) | ✓ | ✓ | ✓ |
| Propose edits from the Word + Google Docs add-ins | — | — | ✓ |

Every plan can search, open the Current version, link a file and see the newer-version notice. Proposing changes from the add-ins needs Pro: on other plans **Propose changes** is shown locked with an upgrade link, and after a downgrade the add-in keeps reading but can no longer propose.

## Install

- **From the Office Store:** in Word, **Home → Add-ins → More add-ins**, search **VersoDocs** and click **Add**. Works in Word for Windows, Mac and the web.
- **For your whole company:** a Microsoft 365 admin deploys it from the admin center (**Settings → Integrated apps → Upload custom apps**) with the [VersoDocs manifest](https://versodocs.com/addins/word-manifest.xml), so it shows up for everyone. The same file sideloads it for a single user (**Add-ins → My add-ins → Upload my add-in** in Word on the web).

Then open it from the **VersoDocs** button on the **Home** tab and click **Sign in to VersoDocs**.

## Use it

- **Open in Word:** search approved documents, pick one, **Open in Word**. The Word document is replaced with the Current version (headings, lists, tables, links and formatting) and linked to it.
- **Link only:** keep what is in the Word document and link it to a VersoDocs document at its Current version, for example a file you already had.
- **Newer version notice:** when a newer version is approved after the one you opened, the pane says so. **Load latest** replaces the content with it.
- **Propose changes** (Pro): give the proposal a title (and optionally what changed and why), then **Propose changes**. The whole Word document becomes the proposed content; reviewers see the diff against Current and approve it in VersoDocs.
- **Unlink** removes the link from the file; the VersoDocs document is not affected.

Pictures go with the proposal: up to 20 PNG, JPEG, GIF or WebP images of up to 5.0 MB each are uploaded to VersoDocs, and the pane says which were left out. Word-only features (comments, tracked changes, page layout) stay in Word. Converting happens in the add-in, on your computer.

## Sign-in, permissions and data

- **Sign in with VersoDocs** (OAuth with PKCE). You pick the organization and approve `docs:read` and `docs:propose`: read approved documents and open proposals (proposing works on Pro). The add-in acts as you: it sees the workspaces you can open, and its proposals are authored by you.
- The connection is listed in **Settings → Developer → Connected AI apps** with your other connections. It does not count toward the plan's API key limit, so even a Free organization can connect it. Revoke it there at any time.
- Nothing is published from Word: every change is a proposal that reviewers approve in VersoDocs.
- The link to a VersoDocs document (organization, document id, title, version) is stored inside the file, so it travels with it. Whoever opens the file still needs their own access.

Under the hood: `GET /api/v1/token` (who am I: organization, plan, scopes), `GET docs` and `GET search` to find documents, `GET docs/{id}` to open one, `GET docs/{id}/current` for the newer-version notice and `POST docs/{id}/proposals` with `content_markdown`. Same endpoints and rules as the [REST API](https://versodocs.com/docs/api.md).