# OnlyOffice Version History — changesUrl Incompatibility Issue
**URL:** https://community.onlyoffice.com/t/onlyoffice-version-history-changesurl-incompatibility-issue/18884
**Category:** Docs
**Created:** [19 March 2026 02:47 UTC](https://community.onlyoffice.com/t/onlyoffice-version-history-changesurl-incompatibility-issue/18884 "2026-03-19T02:47:34Z")
**Posts on this page:** 2
**Page:** 1
### Author:  [@Adam11](https://community.onlyoffice.com/u/Adam11)
#### Post date: [19 March 2026 02:47 UTC](https://community.onlyoffice.com/t/onlyoffice-version-history-changesurl-incompatibility-issue/18884/1 "2026-03-19T02:47:34Z")
### Environment
- OnlyOffice Document Server: 9.2.0
- Frontend component: `@onlyoffice/document-editor-vue` 1.6.1
- File format: xlsx
### Problem Description
We implemented the document version history feature using `onRequestHistory` + `onRequestHistoryData` + `setHistoryData`. When a document has **3 or more versions** , switching to certain versions triggers the following error:
```auto
Received changes that are incompatible with the file version
```
### What We Have Verified
1. **File integrity** : Each version’s `.xlsx` file has a unique MD5 hash — the file contents are correct.
2. **changes.zip validity** : The zip file exists and has a valid structure (contains `changes0.json`).
3. **Key uniqueness** : Each version uses a unique key (we previously fixed a key reuse issue).
### Questions
1. **How can we ensure that the `changesUrl` (changes.zip) returned by Callback `status=2` is fully compatible with the corresponding document version?** Even with correct file contents and unique keys, some versions’ changesUrl is still incompatible with the document.
2. **Is there an event callback for changesUrl compatibility errors in `setHistoryData`?** Currently the error is only logged in the browser console via `app.js`. Neither the `onError` nor `onWarning` events are triggered, making it impossible for the frontend to catch this error.
3. **Is there a recommended way to validate whether a changesUrl is compatible with a document version before calling `setHistoryData`?**
### Related Community Issue
> [@Version History Doesn't Show Appear to Display or Highlight Changes](https://community.onlyoffice.com/t/version-history-doesnt-show-appear-to-display-or-highlight-changes/18444):
>
> I’m not sure if this is a bug or I’m doing something wrong… I have a shared workbook (xlsx format set of spreadsheets). I have followed the instructions in the Document Editor user guide [Version History](https://helpcenter.onlyoffice.com/docs/userguides/document_editor/versionhistory.aspx) page. When I click on Version history (File \> Version History), I can see all the versions in the left side bar over months. However, regardless of which version I click on: The spreadsheet doesn’t refresh or change (page looks the same as the current version, despite knowing that many change…
---
### Author:  [@Nikolas](https://community.onlyoffice.com/u/Nikolas)
#### Post date: [23 March 2026 15:45 UTC](https://community.onlyoffice.com/t/onlyoffice-version-history-changesurl-incompatibility-issue/18884/2 "2026-03-23T15:45:35Z")
Hey @Adam11, 👋
Thanks for the detailed report and for sharing all the verification steps — it’s very helpful!
A few quick notes first:
- You’re currently on **Document Server 9.2.0**. The latest stable version is **9.3.1** , and **9.4** is scheduled for the end of April. So we recommend updating first and re-testing.
Since this is an integration issue (involving `onRequestHistory`, `onRequestHistoryData`, `setHistoryData`, and `changesUrl`), it will take time to investigate. ✍
To move forward faster, could you please provide:
1. **Server logs** (and extended logs if possible) from the moment the error occurs.
2. A **short video** showing the reproduction steps (loading version history → switching versions → error appearing).
3. Confirmation that you implemented version history exactly as described in the official docs:
[Document history | ONLYOFFICE](https://api.onlyoffice.com/docs/docs-api/get-started/how-it-works/document-history/)
If this is time-critical for your project, I’d also recommend considering a **paid license with dedicated professional support** — they can dive into your specific integration much faster:
> [@Get dedicated support](https://community.onlyoffice.com/t/get-dedicated-support/6089/1):
>
> Dear users, We appreciate every request and strive to support the entire community. If your case requires more personal attention please contact [sales@onlyoffice.com](mailto:sales@onlyoffice.com) to receive professional assistance and discuss your query in detail.