Feature Management Module
The Feature Management module implements the
IFeatureManagementStore interface defined by the Feature System.
This document covers only the feature management module which persists feature values to a database. See the features document for more about the feature system.
How to Install
This module comes as pre-installed (as NuGet/NPM packages). You can continue to use it as package and get updates easily, or you can include its source code into your solution (see
get-source CLI command) to develop your custom module.
The Source Code
Feature Management Dialog
Feature management module provides a reusable dialog to manage features related to an object. For example, the Tenant Management Module uses it to manage features of tenants in the Tenant Management page.
When you click Actions -> Features for a tenant, the feature management dialog is opened. An example screenshot from this dialog with two features defined:
In this dialog, you can enable, disable or set values for the features for a tenant.
IFeatureManager is the main service provided by this module. It is used to read and change the setting values for the tenants in a multi-tenant application.
IFeatureManager is typically used by the Feature Management Dialog. However, you can inject it if you need to set a feature value.
If you just want to read feature values, use the
IFeatureCheckeras explained in the Features document.
Example: Get/set a feature's value for a tenant
public class MyService : ITransientDependency
private readonly IFeatureManager _featureManager;
public MyService(IFeatureManager featureManager)
_featureManager = featureManager;
public async Task SetFeatureDemoAsync(Guid tenantId, string value)
.SetForTenantAsync(tenantId, "Feature1", value);
var currentValue = await _featureManager
Feature Management Providers
Features Management Module is extensible, just like the features system. You can extend it by defining feature management providers. There are 3 pre-built feature management providers registered it the following order:
DefaultValueFeatureManagementProvider: Gets the value from the default value of the feature definition. It can not set the default value since default values are hard-coded on the feature definition.
EditionFeatureManagementProvider: Gets or sets the feature values for an edition. Edition is a group of features assigned to tenants. Edition system has not implemented by the Tenant Management module. You can implement it yourself or purchase the ABP Commercial SaaS Module which implements it and also provides more SaaS features, like subscription and payment.
TenantFeatureManagementProvider: Gets or sets the features values for tenants.
IFeatureManager uses these providers on get/set methods. Typically, every feature management provider defines extension methods on the
IFeatureManager service (like
SetForTenantAsync defined by the tenant feature management provider).
If you want to create your own provider, implement the
IFeatureManagementProvider interface or inherit from the
FeatureManagementProvider base class:
public class CustomFeatureProvider : FeatureManagementProvider
public override string Name => "Custom";
public CustomFeatureProvider(IFeatureManagementStore store)
FeatureManagementProvider base class makes the default implementation (using the
IFeatureManagementStore) for you. You can override base methods as you need. Every provider must have a unique name, which is
Custom in this example (keep it short since it is saved to database for each feature value record).
Once you create your provider class, you should register it using the
FeatureManagementOptions options class:
The order of the providers are important. Providers are executed in the reverse order. That means the
CustomFeatureProvider is executed first for this example. You can insert your provider in any order in the
Thank you for your valuable feedback!
Please note that although we cannot respond to feedback, our team will use your comments to improve the experience.