Cache Manager: Now Compatible with Xperience by Kentico v31

Keeping your Xperience by Kentico packages up to date is critical for maintaining a healthy, secure, and performant application. With the release of Xperience by Kentico v31, developers upgrading from v30 may encounter breaking changes when using community packages compiled against earlier platform versions.

Today, we’re releasing an update to our Cache Manager module that restores full compatibility with v31.

The Breaking Change Challenge

If you've recently upgraded your Xperience by Kentico project from v30 to v31 while using Cache Manager v1.0.0, you may have seen the following startup error:

MissingMethodException: Method not found: 
'Void Kentico.Xperience.Admin.Base.UIPageAttribute..ctor(
    System.Type, System.String, System.Type, 
    System.String, System.String, Int32, System.String)'

This error occurs during the assembly discovery phase at application startup. The stack trace typically shows the failure happening in CMS.Core.AssemblyDiscovery.IsAssemblyDiscoverable as the system attempts to load and validate discoverable assemblies.

The root cause is a breaking change in the Admin UI framework introduced in v31. The UIPageAttribute constructor signature changed, and assemblies compiled against earlier API versions reference a constructor that no longer exists. As a result, older binaries fail to load and trigger a MissingMethodException.

This is a common challenge when upgrading actively developed platforms: even small internal API changes require dependent libraries to be recompiled against the new version.

Cache Manager v1.1.0: Full v31 Support

We've released Cache Manager v1.1.0 with updated dependencies targeting Xperience by Kentico v30.0.0+, which ensures compatibility with v31.x and future versions in this dependency range.

Installation

Update your existing Cache Manager installation by modifying your .csproj file:

<PackageReference Include="XperienceCommunity.CacheManager" Version="1.1.0" />

Or use the .NET CLI:

dotnet add package XperienceCommunity.CacheManager --version 1.1.0

Configuration

The configuration remains unchanged from the previous version. Simply ensure you have the service registered in your startup code:

// In your Program.cs or Startup.cs
builder.Services.AddCacheManager();

Compatibility Matrix

Our Commitment to Maintenance

At [A], we understand that community packages are only valuable when they work reliably with the current platform version. We're committed to keeping our Xperience by Kentico packages up to date as the platform evolves.

When Kentico releases new versions, especially major refreshes that may contain breaking changes; we prioritize updating our open-source modules to ensure developers in the community can continue using them without friction. This includes not only the Cache Manager but all of our Xperience community contributions.

If you encounter compatibility issues with any of our packages after a platform update, please don't hesitate to open an issue on GitHub. We actively monitor our repositories and aim to address breaking changes promptly.

Resources

• GitHub Repository: xperience-community-cache-manager
• Release Notes: v1.1.0 Release
• NuGet Package: XperienceCommunity.CacheManager

What's Next?

The Cache Manager continues to provide full visibility into your application's cache, allowing you to browse cache keys, inspect values, and clear the cache directly from the Kentico admin interface. With this update, you can confidently upgrade to Xperience by Kentico v31 while retaining all the cache management capabilities you rely on.

Ready to gain complete visibility into your cache management? Explore how we support Kentico projects and help teams build better digital experiences.

Thank you for reading!

Follow [A] on social:

• LinkedIn

Follow me on social:

• GitHub @vhugogarcia
• LinkedIn victorhugogarcia