# Question about model and server compatibility

**URL:** <https://forum.techsoft3d.com/t/question-about-model-and-server-compatibility/5107>\
**Category:** HOOPS Visualize Web\
**Created:** [March 13, 2026, 3:20pm UTC](https://forum.techsoft3d.com/t/question-about-model-and-server-compatibility/5107 "2026-03-13T15:20:04Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![nick.wong](https://avatars.discourse-cdn.com/v4/letter/n/f0a364/32.png) [@nick.wong](https://forum.techsoft3d.com/u/nick.wong)\
**Post date:** [March 13, 2026, 3:20pm UTC](https://forum.techsoft3d.com/t/question-about-model-and-server-compatibility/5107/1 "2026-03-13T15:20:04Z")

</div>

I would like to confirm the compatibility between minor versions.

Is it true that 202X.Y model always compatible with 202X.Z server, where Z \>= Y? For example 2026.1 model is compatible with 2026.2 server.

But how about 202X.Y model with 2026.Z server, where Y \> Z . For example, 2026.2 model with 2026.1 server.

Thank you

---

<div class="post-metadata">

**Author:** ![tino](https://avatars.discourse-cdn.com/v4/letter/t/9dc877/32.png) [@tino](https://forum.techsoft3d.com/u/tino)\
**Post date:** [March 13, 2026, 7:03pm UTC](https://forum.techsoft3d.com/t/question-about-model-and-server-compatibility/5107/2 "2026-03-13T19:03:19Z")

</div>

To answer your questions:

> [@nick.wong](#):
>
> Is it true that 202X.Y model always compatible with 202X.Z server, where Z \>= Y? For example 2026.1 model is compatible with 2026.2 server.

ANSWER: TRUE  
The server version (and by extension, the Web Viewer) must be **greater or equal to** the Stream Cache model version being loaded.

> [@nick.wong](#):
>
> But how about 202X.Y model with 2026.Z server, where Y \> Z . For example, 2026.2 model with 2026.1 server.

ANSWER: FALSE  
The model cannot be more recent than the server/Web Viewer. This will prompt a `Model Load Error` message in the Web Viewer.

---

<div class="post-metadata">

**Author:** ![nick.wong](https://avatars.discourse-cdn.com/v4/letter/n/f0a364/32.png) [@nick.wong](https://forum.techsoft3d.com/u/nick.wong)\
**Post date:** [March 16, 2026, 1:49pm UTC](https://forum.techsoft3d.com/t/question-about-model-and-server-compatibility/5107/3 "2026-03-16T13:49:05Z")

</div>

> [@tino](#):
>
> must be **greater or equal to** the Stream Cache model version being loaded

I would also like to know the version restriction between server and webviewer. Thank you.

---

<div class="post-metadata">

**Author:** ![tino](https://avatars.discourse-cdn.com/v4/letter/t/9dc877/32.png) [@tino](https://forum.techsoft3d.com/u/tino)\
**Post date:** [March 16, 2026, 1:52pm UTC](https://forum.techsoft3d.com/t/question-about-model-and-server-compatibility/5107/4 "2026-03-16T13:52:32Z")

</div>

The Stream Cache server and the Web Viewer client must be the same version.

---

<div class="post-metadata">

**Author:** ![nick.wong](https://avatars.discourse-cdn.com/v4/letter/n/f0a364/32.png) [@nick.wong](https://forum.techsoft3d.com/u/nick.wong)\
**Post date:** [March 16, 2026, 3:25pm UTC](https://forum.techsoft3d.com/t/question-about-model-and-server-compatibility/5107/5 "2026-03-16T15:25:41Z")

</div>

```javascript
server.connect().then(function(endpointUri) {
    var viewer = new .WebViewer({
      containerId: "viewerContainer",
      endpointUri,
      model: "arboleda",
      enginePath: "/js/hoops"
    })
//...
 viewer.start();
}

```

I would like to see if I misconfig the application or not as I am able to use server 2026.2.0 with viewer 2026.1.

---

<div class="post-metadata">

**Author:** ![tino](https://avatars.discourse-cdn.com/v4/letter/t/9dc877/32.png) [@tino](https://forum.techsoft3d.com/u/tino)\
**Post date:** [March 16, 2026, 3:41pm UTC](https://forum.techsoft3d.com/t/question-about-model-and-server-compatibility/5107/6 "2026-03-16T15:41:20Z")

</div>

Issues may not arise immediately in the case where the server version is greater than the Web Viewer version. For example, if the server is serving the Stream Cache file that now includes a new feature or bug fix, the older Web Viewer client version may not know how to handle this change — resulting in rendering artifacts, error messages, etc.

To avoid this, out of an abundance of caution, we recommend that the server and Web Viewer versions be the same.