abp/docs/en/release-info/migration-guides/abp-10-1.md

//[doc-seo]
{
    "Description": "Upgrade your ABP solutions from v10.0 to v10.1 with this comprehensive migration guide, ensuring compatibility and new features with ABP v10.1."
}

ABP Version 10.1 Migration Guide

This document is a guide for upgrading ABP v10.0 solutions to ABP v10.1. There are some changes in this version that may affect your applications. Please read them carefully and apply the necessary changes to your application.

Open-Source (Framework)

Add New EF Core Migrations for Password History/User Passkey Entities

In this version, we added password history/ user passkeys support to the Identity PRO Module to enhance security compliance. A new IdentityUserPasswordHistory entity has been added to store previous password hashes, preventing users from reusing recent passwords. Additionally, we have introduced an IdentityUserPasskey entity to support passkey-based authentication.

You need to create a new EF Core migration and apply it to your database after upgrading to ABP 10.1.

See #23894 for more details.

PRO

Please check the Open-Source (Framework) section before reading this section. The listed topics might affect your application and you might need to take care of them.

If you are a paid-license owner and using the ABP's paid version, then please follow the following sections to get informed about the breaking changes and apply the necessary ones:

AI Management Module: Workspace Entity Base Class Changed

In this version, the Workspace entity in the AI Management Module has been changed from FullAuditedAggregateRoot to AuditedAggregateRoot as the base class.

This change removes support for soft deletion and related auditing features. If you are using the AI Management module, you need to create a new EF Core migration and apply it to your database.

Important: If you have soft-deleted Workspaces in your database, they will become visible after this update. You may need to create a migration script to clean up already deleted records before applying the migration.

CMS Kit Pro Module: Dynamic FAQ Group Management

In this version, the FAQ group system in the CMS Kit Pro Module has been redesigned to support dynamic group management. FAQ groups are now first-class entities stored in the database, replacing the previous static configuration approach.

Key Changes:

• A new FaqGroup entity has been introduced with unique names for FAQ groups
• The FaqSection entity now uses GroupId (Guid) instead of GroupName (string) (GroupName is deprecated and will be removed soon. Use GroupId instead.)
• Static FAQ group configuration (FaqOptions.SetGroups) has been removed

Migration Steps:

1. Remove static group configuration from your code (e.g., Configure<FaqOptions>(options => { options.SetGroups([...]); }))
2. Create a new EF Core migration and apply it to your database
3. Run the one-time data migration seeder to migrate existing FAQ sections to the new group entity model

Note: If you have existing FAQ data, you may need to create a data seeder to migrate your existing group associations to the new entity-based model.