Migration Guide

Welcome to the SwaggerUI.Themes migration guides. This page helps you upgrade between major versions.

Choose Your Migration Path

Select the guide that matches your current version:

📦 Version 2.x → 3.0 (Latest)

Migration Guide for v3.0

⚠️ BREAKING CHANGES - Version 3.0 introduces significant API changes.

Key Changes:

• Style → Theme API rename
• Unified theme system (no more classic vs modern)
• New standalone themes capability
• useMinified parameter added

---

📦 Version 1.x → 2.0

Migration Guide for v2.0

⚠️ BREAKING CHANGES:

• NoJsModernStyle class removed

---

📦 Version 0.x → 1.0 (Initial)

Migration Guide for v1.0

⚠️ BREAKING CHANGES:

• Namespace update

Quick Version Check

Not sure which version you're using? Check your .csproj file:

<PackageReference Include="AspNetCore.SwaggerUI.Themes" Version="?.?.?" />
<!-- or -->
<PackageReference Include="NSwag.AspNetCore.Themes" Version="?.?.?" />

Need Help?

• Questions? Open an issue on GitHub
• Problems? Check the troubleshooting guide
• Examples? Browse the sample projects

What's New?

After migrating, explore the latest features:

• Predefined Themes - Beautiful built-in themes
• Custom Themes - Create your own themes
• Advanced Options - Enhanced UI features
• CSS Variables - Fine-tune appearance