User Segments allow you to predefine targeting groups for re-use in Feature Gates and Dynamic Configs. Think of it as a reusable macro for a set of users. Need an easy way to roll things out to just your team/org/company? Create a segment, and use a "User is in Segment" or "User is not in Segment" condition in a Feature Gate or Dynamic Config. Let's go through an example. This guide will walk through creating an example segment to identify our internal users, and then using that segment in a new feature we are building.
Start by navigating to the "Segments" tab in the console:
Then click "Create New." Lets call it "Internal Stakeholders:"
Now, lets add some rules to identify those users.
First, lets target people on our internal environments (see our environments guide for more info):
Next, lets add another condition to that same rule. Click "Add more conditions", and then use an "email" "contains any of" condition to target internal employees:
Don't forget to "Save Changes" after adding those! Your Segment should look like this:
Now, lets make a gate for our new feature, "Landing Page Redesign". Navigate to "Feature Gates" and click "Create New"
Since this feature isn't ready for the public, lets gate it to our internal stakeholders using the Segment we just created.
Click "Add New Rule"
Again, remember to "Save Changes"
Fill in the test gate console with any random user input. You won't be able to get this gate to pass until you pass in a user with an email ending
statsig.io AND a development or staging environment like this:
There you have it! You can reuse this Segment in as many Feature Gates or Dynamic Configs as you want to gate your internal features while they are under development.