Directory visibility eligibility reference
This page describes the three conditions a member must meet to appear in a given directory, and explains when admin mode bypasses those conditions.
The three-gate model
Section titled “The three-gate model”A member appears in a directory instance only when all three of the following are true:
| Gate | Condition | How to check |
|---|---|---|
| Member status gate | The member’s effective status is active (or the admin has enabled “Include lapsed” in the directory’s display settings) |
View the member’s record in the admin Members list |
| Member opt-out gate | The member has NOT turned off “Show me in the directory” in their privacy settings (DirectoryPreferences.listed = true) |
Use the admin-mode preview to see opted-out members flagged “Hidden from public” |
| Visibility scope gate | The viewer meets the directory’s configured visibility: public (anyone), members_only (authenticated members), or restricted (member’s level or tag is in the allowed set) |
Check the directory’s Overview tab |
If any one of these gates fails, the member does not appear in the directory for that viewer.
Admin mode
Section titled “Admin mode”Admins with the directory:view-admin-mode permission can open the admin-mode preview, which bypasses all three gates. In admin mode:
- Members of any active status (lapsed, suspended, and so on) are visible.
- Opted-out members are visible, with a “Hidden from public” badge on their card.
- Members outside the directory’s visibility scope are visible.
Admin mode does not bypass the archive gate. Archived members are permanently excluded from all directory views, including admin mode. Archiving is distinct from the active/lapsed status filter.
Viewer context for per-field visibility
Section titled “Viewer context for per-field visibility”Once a member passes all three gates and appears in the directory, what information the viewer sees depends on the viewer’s authentication level. See Per-field visibility options reference for the full table.