# Feature Gate overrides

## Override results of a feature gate

Overrides force specific user IDs to pass or fail a feature gate, regardless of the rules you configure. Use them during development to state explicitly which users see a feature.

Overrides use user IDs, and you can set them to pass or fail for a given user ID. When Statsig evaluates a gate, if the user ID has an override, Statsig returns the overridden result immediately before evaluating any rules.

### Adding an override

- Log into the Statsig console at 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

{% figure %}
![Feature gate page with Add Override button highlighted](https://docs.statsig.com/images/feature-flags/overrides/148461864-4a5efd47-2e40-478f-81e5-49edfc5ea2e9.png)
{% /figure %}

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

{% figure %}
![Manage overrides dialog showing pass and fail lists](https://docs.statsig.com/images/feature-flags/overrides/148462020-417c007f-d492-46f7-8d25-d7a5178b4fe2.png)
{% /figure %}

- 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'

  {% callout type="info" %}
  A user can only exist on one of these lists at a time.
  {% /callout %}

- After you've added the user IDs, select **Save**

### Deleting an override

If you add an override but later decide you don't need it, you can remove it so Statsig evaluates the rules normally.

- Log into the Statsig console at 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

{% figure %}
![Edit overrides button within feature gate settings](https://docs.statsig.com/images/feature-flags/overrides/148469394-9f86db83-26f6-4a5b-809f-8a53f0b4f1fa.png)
{% /figure %}

- Select the trashcan icon next to the user ID you want to remove from a list.

  {% figure %}
  ![Override list with trash icon to remove user ID](https://docs.statsig.com/images/feature-flags/overrides/148463292-6740a09f-337f-441a-9cfa-a547a5dc6183.png)
  {% /figure %}

- After you've updated the lists, select **Save**

### Testing an override

After you add your override, you can test it in the **Test Gate** window by adding `userID` as a property of the user object.

{% figure %}
![Test gate console showing user object with override result](https://docs.statsig.com/images/feature-flags/overrides/148462648-e7da94bb-a681-4b0a-ad53-1254c6abe623.png)
{% /figure %}

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

{% figure %}
![Test gate output indicating PASS due to user ID override](https://docs.statsig.com/images/feature-flags/overrides/148462641-57b544c1-bbdb-48cf-bb7f-967b0b20fc63.png)
{% /figure %}

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

{% figure %}
![Test gate output indicating FAIL due to user ID override](https://docs.statsig.com/images/feature-flags/overrides/148462634-de69b838-f7b1-431c-9119-64ce123ad218.png)
{% /figure %}