diff --git a/website/docs/using-unleash/troubleshooting/flag-not-returned.md b/website/docs/using-unleash/troubleshooting/flag-not-returned.md index 4ba28ca944..92df26442c 100644 --- a/website/docs/using-unleash/troubleshooting/flag-not-returned.md +++ b/website/docs/using-unleash/troubleshooting/flag-not-returned.md @@ -16,3 +16,17 @@ The first thing to look into is to validate that the feature is well configured 1. **Single project access** - Tokens that lead with a project name are bound to the specified project and environment. For example, `my_fullstack_app:production:xyz123etc...` will only have access to flags in the "my_fullstack_app" project as set in the production environment. 1. When using a **gradual rollout** strategy, be mindful of the **[stickiness](/reference/stickiness)** value. When evaluating a flag, if the provided context does not include the field used in the stickiness configuration, the gradual rollout strategy will be evaluated to `false` and therefore it will not be returned by the API. 1. Feature activation strategies can be combined in different ways, which may lead to complex scenarios. Try using the [Playground](/reference/playground.mdx) to verify that the feature is properly configured and responding as expected. + + +If you want to return a flag no matter if it's disabled or enabled you can move the disabled/enabled information into the [strategy variants](/reference/strategy-variants). + +![enabled_disabled_variants](/img/enabled-disabled-variants.png 'Using enabled and disabled variants') + +This flag itself is enabled in development and adds 50%/50% split between disabled/enabled variants. This is essentially the same as a gradual rollout of 50% but using variants. +Remember to use `getVariant` call instead of `isEnabled` call in your SDK. + +You can combine this approach with more complex constraint based targeting. + +![enabled_disabled_variants_complex](/img/enabled-disabled-variants-complex.png 'Using enabled and disabled variants with constraints') + +This flag returns enabled variant for the client with the explicit `semver` and performs percentage split for the remaining clients. diff --git a/website/static/img/enabled-disabled-variants-complex.png b/website/static/img/enabled-disabled-variants-complex.png new file mode 100644 index 0000000000..ff3f0e4d3d Binary files /dev/null and b/website/static/img/enabled-disabled-variants-complex.png differ diff --git a/website/static/img/enabled-disabled-variants.png b/website/static/img/enabled-disabled-variants.png new file mode 100644 index 0000000000..b4ee4ec710 Binary files /dev/null and b/website/static/img/enabled-disabled-variants.png differ