From 4904b5d6c6aed943763e12cdae78dec5750ef700 Mon Sep 17 00:00:00 2001 From: Kim Gustyr Date: Mon, 4 May 2026 12:50:10 +0100 Subject: [PATCH] docs(segments): document segment membership inspection Adds a user-facing section describing the Identities tab on the segment view: where to find it, what it shows, the per-env selector, search by identifier, permissions, and how the freshness story differs between self-hosted and Edge API projects. beep boop --- .../docs/flagsmith-concepts/segments/index.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/docs/flagsmith-concepts/segments/index.md b/docs/docs/flagsmith-concepts/segments/index.md index ca2d3e059921..ab18f8dfe44c 100644 --- a/docs/docs/flagsmith-concepts/segments/index.md +++ b/docs/docs/flagsmith-concepts/segments/index.md @@ -68,6 +68,25 @@ Identity overrides always take precedence over segment overrides. Simply put, th 2. Segment overrides 3. Default value for the current environment +## Inspecting segment membership + +Open a segment from the Segments page and switch to the Identities tab to see who currently matches its rules. Pick an environment from the selector — segments are defined at the project level, but membership is per-environment. Search by identifier to find a specific user. + +The list shows identifiers and the date each identity was first seen. Trait values aren't shown inline; click through to view them. + +You need View permission on the project and View Identities permission on the chosen environment. + +### How fresh is the count? + +Each count is shown with a timestamp telling you when it was computed. + +- Self-hosted: the count updates as identities and traits change. +- [Edge API](/performance/edge-api) projects: SDK writes don't update the count. It only changes when you click Refresh, edit the segment, or change identities from the dashboard. + +### Not yet supported + +Exporting the member list, real-time notifications, multi-segment intersection, and filtering by trait value within the view. Use the Flagsmith API for programmatic access. + ## Context values :::info