1
0
mirror of https://github.com/Unleash/unleash.git synced 2024-12-22 19:07:54 +01:00
unleash.unleash/websitev2/docs/user_guide/create-feature-toggle.md
2021-09-21 16:21:48 +01:00

2.8 KiB
Raw Blame History

id title
create_feature_toggle Create a feature toggle

In this guide you will learn how to create your first feature toggle using Unleash.

Step 1: Click the “create feature toggle” button

The first time you log-in to your Unleash instance you will see an empty list of feature toggles. In order to create a new feature toggle you have to click the “create feature toggle” button

Create a feature toggle

Step 2: Create Feature toggle

After clicking the “create feature toggle” button you will be presented with a form for creating a new feature toggle. You will need to define a few fields before you can actually complete the new feature toggle.

  • Name Must be unique across all your feature toggle. The name must also follow a URL friendly format. Can not be changed.
  • Description A good description makes it easier for other members on your team to understand why this feature toggle exists.
  • Enabled Whether the feature toggle should be enabled or disabled. If the feature toggle is disabled, activation strategy configurations will not be evaluated.
  • Activation strategies A list of one or more activation strategies. An activation strategy is used to enable the feature toggle to a subset, or all, of your users.

In the example below we have chosen to not set up a strategy, which means that the standard strategy will be applied.

Create a feature toggle

Step 3: Congratulations, you have now created your first feature toggle!

The toggle is now created and ready to be used. The toggle does not have any metrics because it is not used by any applications, yet!

Create a feature toggle

Step 4: Enable the feature toggle only for your boss!

The next step is to change the activation strategy to only target your boss. You can use the “userWithId”-strategy for that. Using the configuration shown below will only enable the feature toggle for “boss@company.com” and “me@company.com”. Thus, you can safely test your feature in production, without exposing it to your users. In control roll-out with strategies we will go in to greater details on how to use activation strategies to gradually expose new features to your users.

Create a feature toggle

Summary

In this guide you created your first feature toggle and enabled it for everyone. In later guides we will learn how we can reduce the risk by enabling the toggle for a controlled set of users first.