Skip to content

Document Newtonsoft.Json 10.0.2 → 13.0.1 breaking change for Cosmos provider in EF Core 9.0 #5303

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AndriySvyryd merged 2 commits into from
Mar 25, 2026
Merged

Document Newtonsoft.Json 10.0.2 → 13.0.1 breaking change for Cosmos provider in EF Core 9.0 #5303

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
fa16543
Document Newtonsoft.Json upgrade breaking change for Cosmos provider …
Copilot Mar 24, 2026
66cf1dd
Remove tracking issue link per reviewer feedback
Copilot Mar 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions entity-framework/core/what-is-new/ef-core-9.0/breaking-changes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -348,6 +348,7 @@ Extensive work has gone into making the Azure Cosmos DB provider better in 9.0.
| [Incorrectly translated queries are no longer translated](#cosmos-incorrect-translations) | Medium |
| [`HasIndex` now throws instead of being ignored](#cosmos-hasindex-throws) | Low |
| [`IncludeRootDiscriminatorInJsonId` was renamed to `HasRootDiscriminatorInJsonId` after 9.0.0-rc.2](#cosmos-IncludeRootDiscriminatorInJsonId-rename) | Low |
| [The referenced Newtonsoft.Json version was updated from 10.0.2 to 13.0.1](#cosmos-newtonsoft-json-version) | Low |

### High-impact changes

Expand Down Expand Up @@ -688,3 +689,23 @@ Another related API was renamed to start with `Has` instead of `Include`, and so
##### Mitigations

If your code is using the `IncludeRootDiscriminatorInJsonId` API, simply change it to reference `HasRootDiscriminatorInJsonId` instead.

<a name="cosmos-newtonsoft-json-version"></a>

#### The referenced Newtonsoft.Json version was updated from 10.0.2 to 13.0.1

##### Old behavior

The Cosmos provider referenced Newtonsoft.Json version 10.0.2.

##### New behavior

Starting with EF Core 9.0, the Cosmos provider references Newtonsoft.Json version 13.0.1.

##### Why

The previously referenced version of Newtonsoft.Json has known vulnerabilities. The version was updated to avoid depending on a package version with known security issues.

Comment thread
AndriySvyryd marked this conversation as resolved.
##### Mitigations

The upgrade to Newtonsoft.Json 13.0.1 should not cause issues in most cases. If your application uses Newtonsoft.Json directly and relies on a specific older version, you can update your application to be compatible with Newtonsoft.Json 13.0.1 or later. See the [Newtonsoft.Json release notes](https://github.com/JamesNK/Newtonsoft.Json/releases) for details on changes between versions.
Loading