Alpha Features

April 25, 2026 · View on GitHub

Alpha features are experimental capabilities under active development. They are gated behind feature flags and carry no stability guarantees.

Enabling Alpha Features

Per-feature

azd config set alpha.<featureName> on
azd config set alpha.<featureName> off
# or
azd config unset alpha.<featureName>

All alpha features

azd config set alpha.all on
# Disable all:
azd config set alpha.all off
# or
azd config unset alpha.all

In CI/CD

Set an environment variable for each feature. Both dot notation and underscore notation are supported — dots . in feature names can be kept as-is or replaced with underscores _:

export AZD_ALPHA_ENABLE_<FEATURE_NAME>=true

Discovering Available Features

azd config list-alpha

This lists all currently available experimental features and their enabled/disabled status.

What to Expect

  • No stability guarantees — APIs, behavior, and configuration may change without notice
  • Possible removal — Features may be pulled entirely if the approach doesn't work out
  • Feedback welcome — Alpha features exist to collect signal; report issues and share impressions

Adding a New Alpha Feature

When implementing a new alpha feature:

  1. Register the feature flag in the alpha features configuration
  2. Guard all feature codepaths behind the flag check
  3. Document the feature in azd config list-alpha output

For implementation details, see cli/azd/docs/alpha-features.md.