Skip to content

Upgrading Newtonsoft.Json 10 to 11

Breaking10.0.3 → 11.0.2Breaking1Deprecated1New13Changed12Fixed34

Full comparisonBack to Newtonsoft.Json
BreakingUpgrade verdict

1 breaking change.

In plain terms
  • If a class uses ISerializable but lacks the Serializable attribute, it is now serialized like a normal object instead.
  • The MemberConverter setting on JsonProperty is deprecated and should be avoided.
Must act 2 items need code or config changes

Target frameworks requirement changed in 11.0.1-beta1: .NETFramework2.0, .NETFramework3.5, .NETFramework4.0, .NETFramework4.5, .NETPortable0.0-Profile259, .NETPortable0.0-Profile328, .NETStandard1.0, .NETStandard1.3 → .NETFramework2.0, .NETFramework3.5, .NETFramework4.0, .NETFramework4.5, .NETPortable0.0-Profile259, .NETPortable0.0-Profile328, .NETStandard1.0, .NETStandard1.3, .NETStandard2.0.

What you must change

Breaking1
Types implementing ISerializable without [SerializableAttribute] are no longer serialized using ISerializable.
ISerializableSerializableAttribute
11.0.1GitHub ReleaseSummarizedView source

Deprecations to plan for

Deprecated1
Marks JsonProperty.MemberConverter as obsolete.
JsonProperty.MemberConverter
11.0.1GitHub ReleaseSummarizedView source