Developer docs
Microsoft Word add-in: approved documents in 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, 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:readanddocs: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.