# @carbon/feature-flags > Build with feature flags in Carbon Latest version **1.10.0** (published 2026-09-23) · Apache-2.0 license · 0 weekly downloads ## Install ```sh npm install @carbon/feature-flags pnpm add @carbon/feature-flags yarn add @carbon/feature-flags bun add @carbon/feature-flags ``` ## Health **Score 70/100 (B)** — status: active. Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score. Warnings: low downloads. ## Facts | | | |---|---| | Version | 1.10.0 | | Published | 2026-09-23 | | First published | 2021-03-02 | | Weekly downloads | 0 | | License | Apache-2.0 | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Dependencies | 1 | | Unpacked size | 47.3 KB | | Known vulnerabilities | 0 | | Install scripts | yes | | Provenance | attested (GitHub Actions) | | GitHub stars | 9533 | | Maintainers | carbon-design-system, carbon-bot, leechase, jeffreychew, sstrubberg | | Keywords | ibm, carbon, carbon-design-system, components, react | ## Links - npm: https://www.npmjs.com/package/@carbon/feature-flags - Repository: https://github.com/carbon-design-system/carbon - Homepage: https://github.com/carbon-design-system/carbon#readme - Issues: https://github.com/carbon-design-system/carbon/issues - npm.io page: https://npm.io/package/@carbon/feature-flags ## Dependencies (1) - [@ibm/telemetry-js](https://npm.io/package/@ibm/telemetry-js.md) ^1.5.0 ## Alternatives - [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads - [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads - [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads - [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads - [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads ## Recent versions - 1.10.0 (latest) — 2026-09-23 - 2.0.0-alpha.1 (v12-alpha) — 2026-09-30 - 0.7.3 (v10-next) — 2025-05-14 - 2.0.0-alpha.0 — 2026-09-29 - 1.10.0-rc.0 — 2026-09-21 - 1.9.0 — 2026-09-09 - 1.9.0-rc.0 — 2026-09-08 - 1.8.0 — 2026-08-27 - 1.8.0-rc.0 — 2026-08-24 - 1.7.0 — 2026-08-12 - 1.7.0-rc.0 — 2026-08-10 - 1.6.0 — 2026-07-30 - 1.5.0 — 2026-07-15 - 1.4.0 — 2026-07-01 - 1.4.0-rc.0 — 2026-06-29 - … 74 more at https://npm.io/package/@carbon/feature-flags/versions ## README # @carbon/feature-flags > Build with feature flags in Carbon ## Getting started To install `@carbon/feature-flags` in your project, you will need to run the following command using [npm](https://www.npmjs.com/): ```bash npm install -S @carbon/feature-flags ``` If you prefer [Yarn](https://yarnpkg.com/en/), use the following command instead: ```bash yarn add @carbon/feature-flags ``` ## Usage The `@carbon/feature-flags` provides a runtime-based feature flag system that you can use to enable or disable preview features from Carbon or in your own code. To check if a feature flag is enabled, you can use the `enabled` function in JavaScript: ```js import { enabled } from '@carbon/feature-flags'; enabled('feature-flag-name'); ``` In Sass, you would use the `enabled` function or mixin: ```scss @use '@carbon/feature-flags'; // Return true if the flag is enabled @if feature-flags.enabled('feature-flag-name') { // } @include enabled('feature-flag-name') { // only include contents if the flag is enabled } ``` ### Managing feature flags You can change whether a feature flag is enabled. In JavaScript, you can use the `enable`, `disable`, and `merge` functions to accomplish this. ```js import { enable, disable, merge } from '@carbon/feature-flags'; // Enable `feature-flag-a` enable('feature-flag-a'); // Disable `feature-flag-a` disable('feature-flag-a'); // Set a variety of feature flags to a specific value merge({ 'feature-flag-a': true, 'feature-flag-b': false, 'feature-flag-c': true, }); ``` In Sass, you can configure whether a feature flag is enabled when you include the module or by using `enable`, `disable`, and `merge`. ```scss @use '@carbon/feature-flags' with ( $feature-flags: ( 'feature-flag-a': false, 'feature-flag-b': true, ) ); // Enable `feature-flag-a` @include feature-flags.enable('feature-flag-a'); // Disable `feature-flag-b` @include feature-flags.disable('feature-flag-b'); // Set a variety of feature flags to a specific value @include feature-flags.merge( ( 'feature-flag-a': true, 'feature-flag-b': true, ) ); ``` ## 🙌 Contributing We're always looking for contributors to help us fix bugs, build new features, or help us improve the project documentation. If you're interested, definitely check out our [Contributing Guide](/.github/CONTRIBUTING.md)! 👀 ## 📝 License Licensed under the [Apache 2.0 License](/LICENSE). ## IBM Telemetry IBM Telemetry This package uses IBM Telemetry to collect de-identified and anonymized metrics data. By installing this package as a dependency you are agreeing to telemetry collection. To opt out, see [Opting out of IBM Telemetry data collection](https://github.com/ibm-telemetry/telemetry-js/tree/main#opting-out-of-ibm-telemetry-data-collection). For more information on the data being collected, please see the [IBM Telemetry documentation](https://github.com/ibm-telemetry/telemetry-js/tree/main#ibm-telemetry-collection-basics). --- _Source: https://npm.io/package/@carbon/feature-flags · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._