NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet, #166 most downloaded on NuGet
Provides custom attributes that can be applied to controllers, actions and models to enrich the generated Swagger
Latest stable
11.0.1
Last release 10 days ago
12 Nov 2026
Release timing varies
gaps range from 2 weeks to 4 months
Most releases are documented
notes for 51 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
127 years old
94 releases · first in 1900
Drag across the ruler to compare, or tap a release to open it.
Update v11 migration guide by @martincostello in #4266
SubmitMethod.Query by @martincostello in #4268Full Changelog: v11.0.0...v11.0.1
Important This release contains major breaking changes.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Important
This release contains major breaking changes.
Read our v11 migration guide for further information.
With this release, Swashbuckle.AspNetCore adds support for generating OpenAPI 3.2 documents and for ASP.NET Core 11.
Swashbuckle.AspNetCore v11 depends on OpenAPI.NET v3.11 which introduces some breaking changes to the public API surface. More information can be found in their OpenAPI.NET v3 Upgrade Guide.
To reduce the number of breaking behavioural changes in Swashbuckle.AspNetCore v11, generation of OpenAPI 3.1 and 3.2 documents is opt-in.
To generate OpenAPI 3.1 or 3.2 documents, change the OpenAPI version as shown in the code snippet below:
app.UseSwagger(options =>
{
options.OpenApiVersion = OpenApiSpecVersion.OpenApi3_1;
// ...or
options.OpenApiVersion = OpenApiSpecVersion.OpenApi3_2;
});Tip
It is strongly recommended that you upgrade to Swashbuckle.AspNetCore v10.3.1 before upgrading to v11.
Full Changelog: v10.3.1...v11.0.0
Remove Swashbuckle.AspNetCore.ApiTesting.Xunit by @martincostello in #4188
AmbiguousMatchException for [FromQuery] by @SENESO in #4209ISerializerDataContractResolver by @DevKaurav-14 in #4210Important
Swashbuckle.AspNetCore.ApiTesting.Xunit depended on Xunit v2, which is no longer supported.
The package has been removed and no further versions will be released.
Full Changelog: v10.3.0...v10.3.1
Change nullability handling for schemas with anyOf , allOf , oneOf or type = null by @ldeluigi in #3976
anyOf, allOf, oneOf or type = null by @ldeluigi in #3976AddServer across multiple documents by @RaphaelFakhri in #4115[EnumMember] by @RaphaelFakhri in #4127ConfigObject.AdditionalItems by @RaphaelFakhri in #4132Full Changelog: v10.2.3...v10.3.0
Bump swagger-ui-dist to 5.32.7 by @dependabot in #4015
Full Changelog: v10.2.2...v10.2.3
adec6ea
This commit was created on GitHub.com and signed with GitHub’s verified signature .
GPG key ID: B5690EEEBB952194
Verified Learn about vigilant mode .
Full Changelog : v10.2.2...v10.2.3
dependabot
Update NuGet packages by @martincostello in #3990
SOURCE_DATE_EPOCH by @martincostello in #3997InvalidOperationException if no route matches by @martincostello in #3999[MinLength]/[MaxLength] on dictionary properties to minProperties/maxProperties by @KitKeen in #3922ExposeSwaggerDocumentUrlsRoute behaviour by @martincostello in #4000NUGET_API_KEY by @martincostello in #4006Full Changelog: v10.2.1...v10.2.2
Update Microsoft.OpenApi to 2.7.5 to pick up fix for GHSA-v5pm-xwqc-g5wc by @martincostello in #3974
Full Changelog: v10.2.0...v10.2.1
Add MapSwaggerUI and MapReDoc to support endpoint routing by @Strepto in #3822
MapSwaggerUI and MapReDoc to support endpoint routing by @Strepto in #3822HEAD requests by @snebjorn in #3887IAsyncSwaggerProvider in CLI tofile command by @bt-Knodel in #3910Full Changelog: v10.1.7...v10.2.0
Support custom data type for DataTypeAttribute by @tayfunyuksel in #3868
Full Changelog: v10.1.6...v10.1.7
Fix handling of duplicate enum values for dictionaries by @martincostello in #3839
Full Changelog: v10.1.5...v10.1.6
Bump swagger-ui-dist from 5.31.1 to 5.32.0 in /src/Swashbuckle.AspNetCore.SwaggerUI by @dependabot in https://github.com/domaindrivendev/Swashbuckle.A
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v10.1.4...v10.1.5
Bump swagger-ui-dist from 5.31.0 to 5.31.1 in /src/Swashbuckle.AspNetCore.SwaggerUI by @dependabot in https://github.com/domaindrivendev/Swashbuckle.A
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v10.1.3...v10.1.4
Fix null examples being represented as the string "null" by @jgarciadelanoceda in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3788
"null" by @jgarciadelanoceda in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3788Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v10.1.2...v10.1.3
Fix browser caching behaviour by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3772
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v10.1.1...v10.1.2
Add cache headers to document URLs endpoint by @Copilot and @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3766
Full Changelog:
https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v10.1.0...v10.1.1
Add public method SchemaRepository.ReplaceSchemaId by @bkoelman in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3708
SchemaRepository.ReplaceSchemaId by @bkoelman in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3708AllOf by @John-Paul-R in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3692TryLookupByType with nullability hints by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3719Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v10.0.1...v10.1.0
Prepare for OpenAPI.NET 3.0 by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3647
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v10.0.0...v10.0.1
> This release contains major breaking changes.
[!IMPORTANT]
This release contains major breaking changes.Read our v10 migration guide for further information.
With this release, Swashbuckle.AspNetCore adds support for generating OpenAPI 3.1 documents and for ASP.NET Core 10.
Swashbuckle.AspNetCore v10 depends on OpenAPI.NET v2.3 which introduces many breaking changes to the public API surface. More information can be found in their OpenAPI.NET v2 Upgrade Guide.
To reduce the number of breaking behavioural changes in Swashbuckle.AspNetCore v10, generation of OpenAPI 3.1 documents is opt-in. To generate OpenAPI 3.1 documents, change the OpenAPI version as shown in the code snippet below:
app.UseSwagger(options =>
{
options.OpenApiVersion = OpenApiSpecVersion.OpenApi3_1;
});
[!TIP] It is strongly recommended that you upgrade to Swashbuckle.AspNetCore v9.0.6 before upgrading to v10.
[!IMPORTANT]
Use of Swashbuckle.AspNetCore with the ASP.NET CoreWithOpenApi()method is no longer supported.
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v9.0.6...v10.0.0
Bump redoc from 2.5.0 to 2.5.1 by @dependabot in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3587
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v9.0.5...v9.0.6
.NET 10 preparation by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3565
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v9.0.4...v9.0.5
Fix incorrect ETag values by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3490
ETag values by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3490Accept-Encoding parsing by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3492Accept-Encoding quality by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3493WebHost usage from tests by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3517$type discriminator for [JsonPolymorphic] by @lilinus in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3496Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v9.0.3...v9.0.4
Fix incorrect Content-Length for swagger-ui and Redoc static assets by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pu
Content-Length for swagger-ui and Redoc static assets by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3488Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v9.0.2...v9.0.3
Generate SBOM by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3468
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v9.0.1...v9.0.2
Fix missing Swashbuckle.AspNetCore metapackage dependencies by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3460
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v9.0.0...v9.0.1
📣 This release contains the following breaking changes:
📣 This release contains the following breaking changes:
netstandard2.0 and thus .NET Framework - now only net8.0 and net9.0 are supported.[Obsolete] in previous releases.--serializeasv2 option from Swashbuckle.AspNetCore.Cli, which was superseded by --openapiversion from version 8.0.0.[Range] and respect ParseLimitsInInvariantCulture property by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3448[Range] behaviour by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3449Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v8.1.4...v9.0.0
Avoid ArgumentNullException being thrown generating examples by @skironDotNet in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3444
ArgumentNullException being thrown generating examples by @skironDotNet in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3444Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v8.1.3...v8.1.4
Re-enable MyGet publishing by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3421
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v8.1.2...v8.1.3
Update to fix Lists/Arrays of nullables not getting marked as nullable by @Scarecrow7250 in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v8.1.1...v8.1.2
Bump swagger-ui to 5.20.8 by @dependabot in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3359
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v8.1.0...v8.1.1
Adopt File-scoped namespaces by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3331
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v8.0.0...v8.1.0
To prepare for future support for OpenAPI 3.1 documents, deprecates the SerializeAsV2 property by marking it as [Obsolete]. Users should update their…
[!IMPORTANT]
Swashbuckle.AspNetCore drops support for .NET 6.
Swashbuckle.AspNetCore v8.0.0 makes the following notable changes:
net6.0.netstandard2.0 TFM now depends on ASP.NET Core 2.3 instead of ASP.NET Core 2.1.SerializeAsV2 property by marking it as [Obsolete]. Users should update their code as illustrated below, depending on their use case:- options.SerializeAsV2 = true;
+ options.OpenApiVersion = Microsoft.OpenApi.OpenApiSpecVersion.OpenApi2_0;
// or if explicitly disabling (the same as the default behaviour)
- options.SerializeAsV2 = false;
+ options.OpenApiVersion = Microsoft.OpenApi.OpenApiSpecVersion.OpenApi3_0;
--serializeasv2 option and logs a warning to the console. Users should update their usage as illustrated below, depending on their use case:- swagger tofile --output [output] [startupassembly] [swaggerdoc] --serializeasv2
+ swagger tofile --output [output] [startupassembly] [swaggerdoc] --openapiversion "2.0"
SerializeAsV2 by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3286Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v7.3.2...v8.0.0
Fix humanize for multiline code and tags by @EvgeniyZ in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3295
code and <para> tags by @EvgeniyZ in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3295DescribeAllParametersInCamelCase usage for parameters by @maksim-sovkov in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3309Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v7.3.1...v7.3.2
Fix for ApiDescriptionProvider throws NRE by @EvgeniyZ in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3280
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v7.3.0...v7.3.1
Add CreateFromJson options overload by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3218
CreateFromJson options overload by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3218JsonSerializerDataContractResolver so that it handles jagged arrays correctly by @ozziepeeps in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3245DeepObject parameter style for dictionary by @EvgeniyZ in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3241MvcOptions from SchemaGenerator by @EvgeniyZ in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3242Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v7.2.0...v7.3.0
Path grouping strategy by @Saibamen in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3152
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v7.1.0...v7.2.0
Update some nugets by @Saibamen in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3143
SwaggerGeneratorTests by @Saibamen in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3147ResponseDescriptionMap by @Saibamen in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3148[FromForm] and enums for Controllers by @jgarciadelanoceda in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3164[Description] and [ReadOnly] by @jgarciadelanoceda in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3162UseOneOfForPolymorphism by @k0ka in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3155NotSupportedException in AoT test project by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3171snupkg files by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3168[JsonPolymorphic] and [JsonDerivedType] attributes by @k0ka in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3170Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v7.0.0...v7.1.0
Refactor filter descriptor type checks in SwaggerGen by @iskandersierra in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3125
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v6.9.0...v7.0.0
Generate Properties whenever there are objects without schema(Not onl… by @jgarciadelanoceda in https://github.com/domaindrivendev/Swashbuckle.AspNetC
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v6.8.1...v6.9.0
Fix issue when applying filters for WithOpenApi extension by @jgarciadelanoceda in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3085
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v6.8.0...v6.8.1
Added dependency injection/easy registration for async filters by @tofi92 in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3030
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v6.7.3...v6.8.0
Fix nested types nullable context check by @VladimirTyrin in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3043
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v6.7.2...v6.7.3
Use NullabilityInfoContext to determine dictionary value nullability by @patrikwlund in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull
Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v6.7.1...v6.7.2
docs: Update README.md by @WeihanLi in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/3002
[DataMember] IsRequired in NewtonsoftDataContractResolver by @ouvreboite in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2644Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v6.7.0...v6.7.1
Allow Swagger UI CSS and JS paths to be configurable by @mag1art in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2908
IncludeXmlCommentsForAssembly() convience overload by @leotsarev in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2909[FromForm] with [SwaggerIgnore] by @jgarciadelanoceda in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2928[AsParameters] throwing error on cast when showing the description with EnableAnnotations() by @jgarciadelanoceda in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2962RequestBodyFilterAnnotation and MultipleFromForm for Minimal APIs by @jgarciadelanoceda in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2963IFomFile/IFormFileCollection by @jgarciadelanoceda in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2972IFormFile with OpenAPI by @jgarciadelanoceda in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2979ApiParameter.Type by @jgarciadelanoceda in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2980HttpMethods.IsGet() by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2971Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v6.6.2...v6.7.0
Fix to make required and nullable properties nullable in schema by @keahpeters in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2879
[Length]attribute. by @satma0745 in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2882<br />, <br/>, and <br> in XML comments with Environment.Newline by @mburumaxwell in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2899AdditionalItems by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2890IHostedService implementations by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2880[DefaultValue]'s type differs by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2895Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v6.6.1...v6.6.2
Modernise build and migrate to GitHub Actions for CI by @martincostello in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2775
WithSummary and WithDescription metadata by @hwoodiwiss in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2414Add Security Definitions and Requirements for Bearer auth URL by @Saibamen in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2705GetInheritanceChain by @angelaki in https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/2826Full Changelog: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/compare/v6.5.0...v6.6.1
Changes since v6.4.0
Changes since v6.3.0
Nothing published for this version
Changes since `v6.3.0`
Changes since `v6.2.3`
Changes since `v6.1.3`
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.