8.6.0-preview

What's Changed

• Bug fix: The registered failture status should be used when health check fails by @zhiyuanliang-ms in #714
• AzureAppConfigurationRefresherProvider finds IConfigurationRefresher by @zhiyuanliang-ms in #715
• Merge main to preview by @zhiyuanliang-ms in #720
• Dependency upgrade by @linglingye001 in #721
• Version bump 8.5.0 by @linglingye001 in #723
• Optimization for azure front door watch requests by @linglingye001 in #717
• Merge main to preview 2/26 by @linglingye001 in #725
• Version bump 8.6.0-preview by @linglingye001 in #726
• Merge preview to release/preview/v8 by @linglingye001 in #727

Full Changelog: 8.5.0-preview...8.6.0-preview

8.5.0

What's Changed

• Add AlwaysHealthy health check when provider is disabled by @zhiyuanliang-ms in #700
• Bug fix: The registered failture status should be used when health check fails by @zhiyuanliang-ms in #714
• AzureAppConfigurationRefresherProvider finds IConfigurationRefresher by @zhiyuanliang-ms in #715
• Dependency upgrade by @linglingye001 in #721
• Version bump 8.5.0 by @linglingye001 in #723
• Merge main to release/stable/v8 by @linglingye001 in #724

Full Changelog: 8.4.0...8.5.0

8.5.0-preview

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.5.0-preview - November 14th, 2025

Enhancements

• Added a new method ConnectAzureFrontDoor to AzureAppConfigurationOptions, which can be used to load configuration settings from Azure App Configuration via an Azure Front Door endpoint. This enables client (browser) applications to take advantage of CDN benefits, such as scale, when fetching configuration. #706

Microsoft.Azure.AppConfiguration.AspNetCore 8.5.0-preview - November 14th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.5.0-preview. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.5.0-preview - November 14th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.5.0-preview. See the release notes for more information on the changes.

8.4.0

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.4.0 - September 19th, 2025

Enhancements

• Added an overload of AddAzureAppConfiguration that accepts the endpoint and token credential. #694

• Added support for parsing json values with comments. #685

• Added support for snapshot references. If a configuration setting's value is a snapshot reference, loading it automatically pulls all key-values and feature flags from the referenced snapshot into the configuration. This enables dynamically switching between snapshots at runtime. #689

• Updated dependency package versions. #695

  • Azure.Data.AppConfiguration: 1.6.0 -> 1.6.1
  • Azure.Messaging.EventGrid: 4.7.0 -> 5.0.0
  • Azure.Security.KeyVault.Secrets: 4.6.0 -> 4.8.0
  • Microsoft.Extensions.Diagnostics.HealthChecks: 6.0.36 -> 8.0.19
  • Microsoft.Extensions.Azure: 1.7.6 -> 1.12.0
  • Microsoft.Extensions.DependencyInjection.Abstractions: 6.0.0 -> 8.0.2
  • Microsoft.Extensions.Logging: 6.0.0 -> 8.0.1
  • Microsoft.Extensions.Configuration: 6.0.1 -> 8.0.0

Microsoft.Azure.AppConfiguration.AspNetCore 8.4.0 - September 19th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.4.0. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.4.0 - September 19th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.4.0. See the release notes for more information on the changes.

8.3.0

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.3.0 - July 24th, 2025

Enhancements

• Added health check integration for Microsoft.Extensions.Diagnostic.HealthChecks. You can call AddAzureAppConfiguration on IHealthCheckBuilder to register a health check for the Azure App Configuration provider. #644

  builder.Services
     .AddHealthChecks()
     .AddAzureAppConfiguration();

• Introduced a new environment variable AZURE_APP_CONFIGURATION_FM_SCHEMA_COMPATIBILITY_DISABLED to force processing and outputting feature flags using the Microsoft schema. #676

Microsoft.Azure.AppConfiguration.AspNetCore 8.3.0 - July 24th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.3.0. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.3.0 - July 24th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.3.0. See the release notes for more information on the changes.

8.2.0

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.2.0 - May 14th, 2025

Enhancements

• Updated the existing Select APIs with the new parameter tagFilters to support filtering key-values and feature flags by tags.

  public AzureAppConfigurationOptions Select(string keyFilter, string labelFilter = LabelFilter.Null, IEnumerable<string> tagFilters = null)

  public FeatureFlagOptions Select(string featureFlagFilter, string labelFilter = LabelFilter.Null, IEnumerable<string> tagFilters = null)

• Added an ActivitySource called Microsoft.Extensions.Configuration.AzureAppConfiguration to support instrumentation. A Load activity will start when configuration is initially built and the Refresh activity will start when a refresh is triggered. #645

• This is the first stable release of the AzureAppConfigurationOptions.SetClientFactory API introduced in 8.2.0-preview. #380

  public AzureAppConfigurationOptions SetClientFactory(IAzureClientFactory<ConfigurationClient> factory)

Other Changes

• Removed the FeatureFlagId property from feature flag telemetry. #655
• Shortened default network timeout for requests to App Configuration to improve failover speed and retry responsiveness. #657
• This is the first stable release of AllocationId from feature flag telemetry metadata, which was introduced in 8.1.0-preview. #600

Microsoft.Azure.AppConfiguration.AspNetCore 8.2.0 - May 14th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.2.0. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.2.0 - May 14th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.2.0. See the release notes for more information on the changes.

8.1.2

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.1.2 - April 22nd, 2025

Bug Fixes

• Calling IServiceCollection.AddAzureAppConfiguration now correctly adds an instance of IConfigurationRefresherProvider to the service collection only the first time it is called instead of adding an instance on each invocation. #611

Microsoft.Azure.AppConfiguration.AspNetCore 8.1.2 - April 22nd, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.2. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.1.2 - April 22nd, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.2. See the release notes for more information on the changes.

8.2.0-preview

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.2.0-preview - March 21st, 2025

Enhancements

• Added the ability to set a client factory used for creating ConfigurationClient instances. #380

  public AzureAppConfigurationOptions SetClientFactory(IAzureClientFactory<ConfigurationClient> factory)

Microsoft.Azure.AppConfiguration.AspNetCore 8.2.0-preview - March 21st, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.2.0-preview. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.2.0-preview - March 21st, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.2.0-preview. See the release notes for more information on the changes.

8.1.1

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.1.1 - February 26th, 2025

Bug Fixes

• Fixed a bug introduced in the 8.1.0 release where calls to FeatureFlagOptions.Select were ignored if they were followed by a call to either AzureAppConfigurationOptions.Select or AzureAppConfigurationOptions.SelectSnapshot. #628

Microsoft.Azure.AppConfiguration.AspNetCore 8.1.1 - February 26th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.1. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.1.1 - February 26th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.1. See the release notes for more information on the changes.

8.1.0

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.1.0 - February 24th, 2025

Enhancements

• Added the ability to monitor all selected key-values for refresh with the following new API. #536

  public AzureAppConfigurationRefreshOptions RegisterAll()

  When this API is called, changes to any selected key-values will cause a reload of the configuration.

• Added the ability to check if the type of an IConfigurationSource is AzureAppConfigurationSource with the following new extension. #456

  public static bool IsAzureAppConfigurationSource(this IConfigurationSource source)

Bug Fixes

• Fixed a bug where changing a feature flag would always override an already loaded feature flag with the same key but different label on refresh. As part of this change, feature flags are now always refreshed as a collection, meaning a change in any selected flag will result in a reload of all selected feature flags on refresh. #317
• Fixed a bug where an unnecessary refresh could occur when a request to App Configuration was served from the cache. #588

Other Changes

• Removed support for the configuration_reference property in feature flags. #614
• AllocationId from feature flag telemetry metadata, which was introduced in 8.1.0-preview version, has been removed in this stable version. #600

Microsoft.Azure.AppConfiguration.AspNetCore 8.1.0 - February 24th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.0. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.1.0 - February 24th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.0. See the release notes for more information on the changes.