Technical Debt
Overview
Feature flag technical debt accumulates when you don’t manage or retire feature flags after their intended use. Over time, the codebase becomes cluttered with outdated flags, making the code more complex and harder to maintain. This can slow productivity as developers spend more time understanding and navigating the code.
Stale feature flags can also introduce risks, such as security vulnerabilities, by unintentionally exposing sensitive features or data. Additionally, the presence of stale or conflicting feature flags can lead to unexpected application behavior, increasing the risk of downtime and affecting overall stability. Managing feature flags effectively minimizes these risks and ensures a healthier development process.
Stale and potentially stale flags
A feature flag can have one of the following states: active, potentially stale, or stale. Unleash marks all flags as potentially stale automatically once they pass their expected lifetime. This gives you an indication of when to review and clean up a feature flag in code.
You can also manually mark a feature flag as stale if you know it has served its intended purpose. To do so, click Toggle stale state on the flag's details page.
Alternatively, you can mark one or more flags as stale from the project overview page. In the Feature flags list, select the affected flags and click Mark as stale.
Marking a flag as stale allows you to deprecate a feature flag without removing the active configuration for connected applications. You can use this to signal to your team to stop using the feature in your applications. Stale flags will show as stale in the technical debt dashboard.
Marking a flag as stale generates the feature-stale-on event. You can use an integration to trigger automated workflows, such as posting notifications in a Slack channel, breaking project builds if the code contains stale flags, or automatically opening pull requests to remove stale flags from the code.
To find stale and potentially stale flags in a project, apply the State filter in the Feature flags list.
While a flag's state does not affect its behavior in applications, using states to manage flags helps reduce technical debt and maintain a cleaner codebase.
Project status
Each project has a Project status dashboard, where you can view its health status and the total number of unhealthy flags. All active flags are considered healthy, while stale and potentially stale flags are considered unhealthy. To keep your project in a healthy state, archive stale feature flags and remove code from your codebase.
Your overall project health rating is the percentage of healthy flags in your project. To view your project health over time, go to Insights.
Project status updates every hour. Changes to flags, such as adding, removing, or changing their state, may take some time to reflect.