The Users dashboard
Read time: 4 minutes
Last edited: Nov 02, 2021
This topic explains what the Users dashboard is, how it is populated, and how to use it.
The Users dashboard gives you a summary view of how each user sees all of the features on your site, and lets you customize their experience from one screen. You can even set expiration dates for flag targeting, or remove flags targeted to individual users.
The Users dashboard populates automatically when users encounter a feature flag and are evaluated by a LaunchDarkly SDK. The data on the Users dashboard is populated from the user data you send in
variation calls, as well as data from
identify calls. To learn more about users and user attributes, read Understanding user attributes.
You cannot create users in the Users dashboard. The Users dashboard is not a database, and exists to serve users that have already been evaluated by a LaunchDarkly SDK. Evaluation always happens with the SDK locally on the machine.
If a user's properties change within five minutes of their previous evaluation, and the user key stays the same, the Users dashboard deduplicates the user and does not reflect the latest evaluation. This does not affect variation calls, which always use the attribute values passed to them.
Here is an screenshot of the Users dashboard:
From the Users dashboard, you can filter users by standard or custom attributes. You can also sort the list to identify the oldest or most recent users in your LaunchDarkly account. By default, the most recently active users appear first. Click the toggle arrow to sort the Last Seen column to sort the dashboard by least recently active users.
To learn more about how the Users dashboard is populated, and how you might exceed the 100,000,000 user limit, read Anonymous users.
You can filter users on the dashboard by standard or custom attributes.
To filter users:
- Click the Filter button.
- Choose a standard or custom attribute to filter users by:
- Choose an attribute value from the dropdown.
- Click Add.
Only users with matching attribute values now display on the Users dashbaord.
To add additional attribute values to your filter, click on the attribute name and select the additional values from the dropdown. The dashboard displays only users that match all of the attribute values you selected:
To remove a filter, click on the attribute name you want to stop filtering by and click Clear filter.
You can customize which attributes appear on the Users dashboard. To start, click the Attributes button.
Here is a screenshot of the Attributes button on the Users dashboard:
The "Attributes" menu lets you choose standard or custom attributes to appear on the Users dashboard. After you choose specific attributes, that view persists when you visit the Users dashboard in the future.
Here is a screenshot of the "Attributes" menu:
Click a user to manage the feature flags that apply to them, view the segments they are in, and view a full list of their attributes.
To modify a feature flag the user sees:
Navigate to the Users dashboard.
Click the user you wish to modify. Their user page appears, with their unique Attributes on the left and their Flag settings on the right.
Click the dropdown next to the flag you wish to modify to change which variation the user receives:
To remove the custom variation setting, click the X next to the flag.
Click Save Settings to save your changes.
The Users page shows only cached user information. Users appear in the dashboard for 30 days from creation. If a flag sends a
flag evaluation event for a user less than 30 days after it sent the previous event, the user will remain on the dashboard.
If a feature flag does not send an
flag evaluation event for a user within 30 days of creation, they age out of the system and their information no longer appears in the Users dashboard. Those users reappear on the dashboard when a flag sends an
flag evaluation event again, if your account has not reached the maximum number of users.
If you want to keep users on the dashboard for longer than 30 days between flags sending
flag evaluation events, you can manually call
identify for all of the users that you wish to retain. To learn how to do this in your SDK, read Identifying and changing users.
Accounts are limited to 100,000,000 users. If you reach the users limit, flag evaluations will still work for new users, but they won't appear on the Users dashboard until stale users age out of the 30-day user cache and your users drop below 100,000,000. To learn more, read Understanding client-side MAU limits.
If you want to increase your client-side Monthly Active Users (MAU) limit to see more users from your client-side SDKs on the user dashboard, contact Support.
You can also specify a date and time when a user should be removed from a flag's targeting settings. When this date and time arrives, LaunchDarkly removes the user from the flag's targeting automatically.
You can identify users who are scheduled to be removed from any flag's targeting settings by looking for the clock icon next to the flag's name.
To schedule a date for the user to be removed from the flag's targeting settings:
- Navigate to the Users dashboard.
- Click the user you wish to modify. Their user page appears, with their unique Attributes on the left and their Flag settings on the right.
- Click the overflow menu. The user editing menu appears.
- In the "Remove user on" section, click to expand a calendar view.
- Set a date and time for the user to be removed from that flag's targeting settings.
- Click Save with Comment.
When you schedule a user to be removed from a flag, a clock icon appears next to the flag's varation. Hover over it to see when that user will be removed.
To learn more about targeting users for specific dates, read Scheduling expiration dates for user targeting.
You can delete individual users from the dashboard, or by opening their page and clicking the Delete button.
Deleting users from the dashboard does not decrease your Monthly Active User (MAU) count.
Here is an image of a user screen:
You can also use the LaunchDarkly API to delete users. To learn more, read the API docs.