> ## Documentation Index
> Fetch the complete documentation index at: https://statsig-4b2ff144-mintlify-add-local-eval-country-note-96362.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Feature Gate overrides

> During development, it can be useful to explicitly state which users should pass or fail a given feature gate. This is where overrides come in.

## Override results of a feature gate

During development, it can be useful to explicitly state which users should pass or fail a given feature gate. This is where overrides come in.

Overrides are based of user IDs and can be set to pass or fail for a given user ID. During evaluation of a gate, if the user ID is overridden, the overridden result will be returned immediately before any rules are evaluated.

### Adding an Override

* Log into the Statsig console at [https://console.statsig.com](https://console.statsig.com)
* On the left-hand navigation panel, select **Feature Gates**
* Select the feature gate where you want to add an Override
* Click the **Add Override** button

<Frame>
  <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/XTE_2_TFM5ma_nLC/images/feature-flags/overrides/148461864-4a5efd47-2e40-478f-81e5-49edfc5ea2e9.png?fit=max&auto=format&n=XTE_2_TFM5ma_nLC&q=85&s=f05d4af0bba5f23a2d005f4a997c12f4" alt="Feature gate page with Add Override button highlighted" width="717" height="125" data-path="images/feature-flags/overrides/148461864-4a5efd47-2e40-478f-81e5-49edfc5ea2e9.png" />
</Frame>

* Select either 'Pass List' or 'Fail List' from the tabs in the dialog

<Frame>
  <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/XTE_2_TFM5ma_nLC/images/feature-flags/overrides/148462020-417c007f-d492-46f7-8d25-d7a5178b4fe2.png?fit=max&auto=format&n=XTE_2_TFM5ma_nLC&q=85&s=e6f3b6eea0f3969780bb422fd8d3fb89" alt="Manage overrides dialog showing pass and fail lists" width="530" height="478" data-path="images/feature-flags/overrides/148462020-417c007f-d492-46f7-8d25-d7a5178b4fe2.png" />
</Frame>

* For users you want to pass the gate, add them to the 'Pass List'

* For users you want to fail the gate, add them to the 'Fail List'

  <Info>
    A user can only exist on one of these lists at a time.
  </Info>

* Once you have added the user IDs, hit **Save**

### Deleting an Override

If you add an override but later decide it is no longer needed. You can remove it so the rules will be evaluated as normal.

* Log into the Statsig console at [https://console.statsig.com](https://console.statsig.com)
* On the left-hand navigation panel, select **Feature Gates**
* Select the feature gate where you want to add an Override
* Click the **Edit Overrides** button

<Frame>
  <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/XTE_2_TFM5ma_nLC/images/feature-flags/overrides/148469394-9f86db83-26f6-4a5b-809f-8a53f0b4f1fa.png?fit=max&auto=format&n=XTE_2_TFM5ma_nLC&q=85&s=75656bb99eaa8d62800f1462731d5169" alt="Edit overrides button within feature gate settings" width="730" height="128" data-path="images/feature-flags/overrides/148469394-9f86db83-26f6-4a5b-809f-8a53f0b4f1fa.png" />
</Frame>

* Hit the trashcan icon next to the user ID you wish to remove from a list.

  <Frame>
    <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/XTE_2_TFM5ma_nLC/images/feature-flags/overrides/148463292-6740a09f-337f-441a-9cfa-a547a5dc6183.png?fit=max&auto=format&n=XTE_2_TFM5ma_nLC&q=85&s=652abff4e4fa517d553533b314deb6f0" alt="Override list with trash icon to remove user ID" width="492" height="523" data-path="images/feature-flags/overrides/148463292-6740a09f-337f-441a-9cfa-a547a5dc6183.png" />
  </Frame>

* Once you have updated the lists, hit **Save**

### Testing an Override

Once your override has been added, you can test it in the "Test Gate" window by simply adding userID as a property of the user object.

<Frame>
  <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/XTE_2_TFM5ma_nLC/images/feature-flags/overrides/148462648-e7da94bb-a681-4b0a-ad53-1254c6abe623.png?fit=max&auto=format&n=XTE_2_TFM5ma_nLC&q=85&s=abb1efb37f1355842255c7e5b9a735e6" alt="Test gate console showing user object with override result" width="703" height="195" data-path="images/feature-flags/overrides/148462648-e7da94bb-a681-4b0a-ad53-1254c6abe623.png" />
</Frame>

Users that pass will see "PASS (User ID Override)"

<Frame>
  <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/XTE_2_TFM5ma_nLC/images/feature-flags/overrides/148462641-57b544c1-bbdb-48cf-bb7f-967b0b20fc63.png?fit=max&auto=format&n=XTE_2_TFM5ma_nLC&q=85&s=ac3a1e8acdc5b224b7d8fa3df9416764" alt="Test gate output indicating PASS due to user ID override" width="715" height="94" data-path="images/feature-flags/overrides/148462641-57b544c1-bbdb-48cf-bb7f-967b0b20fc63.png" />
</Frame>

Users that fail will see "FAIL (User ID Override)"

<Frame>
  <img src="https://mintcdn.com/statsig-4b2ff144-mintlify-add-local-eval-country-note-96362/XTE_2_TFM5ma_nLC/images/feature-flags/overrides/148462634-de69b838-f7b1-431c-9119-64ce123ad218.png?fit=max&auto=format&n=XTE_2_TFM5ma_nLC&q=85&s=20569ac345625f76c40ec387f24315dd" alt="Test gate output indicating FAIL due to user ID override" width="698" height="74" data-path="images/feature-flags/overrides/148462634-de69b838-f7b1-431c-9119-64ce123ad218.png" />
</Frame>
