Blacklist Management
Overview
The Blacklist feature lets you block problematic guests or members from accessing your facility — at either the facility level or across your entire organization. It is managed on a dedicated tab within the Members page (/members?tab=blacklist), independent of Membership management.
There are four sources for blacklist entries: automatic revocation from a membership subscription (membership), reservation cancellation (reservation), check-in operations (checkin), and manually added by a Facility Owner, Organization Owner, or Platform Admin (manual).
Detailed Features
Feature 1: Viewing the Blacklist
Navigate to Members in the menu and click the Blacklist tab. All active blacklist entries for your organization are displayed.
Information Shown
Each entry shows the guest's identity information (name, email, phone, nationality) alongside the following badges:
| Badge | Description |
|---|---|
| Source | membership / reservation / checkin / manual |
| Scope | Organization-wide / Facility only |
| Blocked date | When the entry was created |
Clicking an entry navigates to the member detail page (only available when a guest profile is linked).
Visible Entries by Role
| Role | Visible entries |
|---|---|
| Platform Admin | All entries in the organization |
| Organization Owner | All entries in the organization |
| Facility Owner | Own facility entries + organization-scoped entries |
Feature 2: Manually Adding an Entry
Facility Owners, Organization Owners, and Platform Admins can add any guest to the blacklist using the Add Entry button.
Input Fields
| Field | Required | Description |
|---|---|---|
| Email address | Yes | Email of the guest to block. Matched against existing guest profiles |
| Scope | Yes | Organization-wide (default) or Facility only |
| Reason | Optional | Internal note. Not shown to the guest |
Scope Differences
| Scope | Effect |
|---|---|
| Organization-wide | Blocks the guest across all facilities in the organization. facility_id is stored as NULL |
| Facility only | Blocks the guest at the current facility only. Other facilities are unaffected |
Tip: Choose Organization-wide to ensure the same email address is blocked even if the guest visits a different facility within your organization.
Steps
- Open the Members page and click the Blacklist tab
- Click the Add Entry button in the top-right corner
- Enter the email address, scope, and an optional reason
- Click Add to save
Feature 3: Removing a Blacklist Entry (Unblock)
Click the Unblock button on the bottom-right of any entry card and confirm in the dialog. This sets the entry to inactive (is_active = false).
The entry remains in the database for audit purposes. To re-block the same guest, create a new entry.
Feature 4: Automatic Entry via Membership Subscription
When you blacklist a member from the Membership management page, the following happens automatically:
- The Stripe subscription is cancelled (the ban takes effect even if the Stripe cancellation fails)
- The subscription status is updated to
revoked - The member is removed from
role_membersandfacility_members - A blacklist entry is created (source:
membership)
If the Stripe cancellation fails, the ban remains active but an operator warning is surfaced to prompt manual reconciliation in Stripe.
Scope and user_id Behavior
user_id-null Entries (email-only)
Guests who have not yet registered an account can still be blacklisted by email address alone. The user_id field is stored as NULL, but check-in blocking by email remains fully effective.
Organization Scope Rule
Entries with scope = 'organization' always have facility_id = NULL. This is enforced automatically to ensure org-wide bans are visible across all facilities in the organization (schema constraint added in migration 20260519150000).
FAQ
Q: Can a blacklisted guest still check in?
No. Any guest whose email address or user ID matches an active blacklist entry will be blocked at check-in. If the scope is Organization-wide, the block applies to all facilities in the organization.
Q: Is the guest notified when they are blacklisted?
There is currently no notification to the guest. They will be denied entry when they attempt to check in.
Q: Can a Facility Owner see entries from other facilities?
No. Facility Owners can only see entries for their own facility and organization-scoped entries (which apply to all facilities).
Q: Can I restore an unblocked entry?
Entries are deactivated, not deleted. To re-block the same email, create a new entry manually.
Troubleshooting
An entry I added is not showing up
- If you added the entry with Organization-wide scope,
facility_idis NULL. It should be visible from any facility in the same organization. - Try refreshing the page to reload the list.
A guest is still blocked after being unblocked
- Check whether another active entry exists for the same email address (you may have both an Organization-wide and a Facility-only entry active simultaneously).