Skip to content

Upgrading Swashbuckle.AspNetCore 10 to 11

Breaking10.3.1 → 11.0.1Breaking1Platform1New2Changed1Fixed5Other4

BreakingUpgrade verdict

1 breaking change and a platform requirement change.

  • The underlying OpenAPI library was upgraded to a version with incompatible API changes, so code that touches those types may need updates.
  • The package now works with the next major version of ASP.NET Core.
2 items need code or config changes

Swashbuckle.AspNetCore publishes official migration guides for versions 11, 11. They cover more than the release notes do.

V11 migration guide ↗OpenAPI.NET v3 Upgrade Guide ↗

Target frameworks requirement changed in 11.0.0: net10.0, net8.0, net9.0 → net10.0, net11.0.

Moves microsoft.extensions.apidescription.server 9.0.0 → 11.0.0. Your build may pick other versions.

3 packages of its own release move with it.

Breaking1
Depends on OpenAPI.NET v3.11, which introduces breaking changes to the public API surface.
Platform1
Adds support for ASP.NET Core 11.