Skip to main content

๐ŸŽŸ๏ธ Door Pass โ€” Event Entry Gating

Gate entry to your Study Room events with verifiable passes, gatekeeper admission, and attendee management โ€” for both physical and virtual events.

๐ŸŽŸ๏ธWhat is Door Pass?

Door Pass is a feature that lets room owners gate entry to events. Every attendee who claims a spot receives a unique verification code they show at the door (or use to access a virtual meeting). A gatekeeper verifies the code and admits them.

This works for any kind of event: book club meetings, lectures, workshops, trade shows, weddings, conferences โ€” anything where you need to know who is coming and actually show up.

๐Ÿ”‘Verifiable Entry

Every pass has a unique 8-character code (like EVT-A7K3) that gatekeepers look up in real time. No paper tickets, no confusion.

๐Ÿ‘ฎDedicated Gatekeeper Role

A GATEKEEPER room role lets you delegate door duty without giving away moderator powers. Owners and moderators can also work the door.

๐Ÿ“ŠLive Check-In Tracking

See exactly how many people have arrived and how many spots remain โ€” updated in real time via Ably.

๐Ÿ’ปWorks for Virtual Events Too

Virtual events use passes to gate access to the meeting URL. Attendees must have a pass to see the Join Meeting button, preventing link sharing.

โš™๏ธEnabling Door Pass for your room

Door Pass is a room-level feature. The room owner must enable it before any events can use it.

1

Go to Room Settings

Navigate to your Study Room and click Settings. Scroll to the Door Pass section, or navigate to /study-rooms/[your-room]/settings/doorpass.

2

Toggle Door Pass on

Flip the toggle to Enabled. This makes the Door Pass option available when creating events in this room. Existing events are unaffected โ€” only new events can opt in.

โ„น๏ธOnly the room owner (or site admin) can toggle this setting. Moderators and gatekeepers cannot change it.
3

Create an event with Door Pass

When creating a new event, you will now see a "Require Pass for Entry" checkbox (only if the room has Door Pass enabled). Check it to require passes for this event.

Additional options appear when enabled:

  • Pass Type: RSVP (members claim a free pass) or Free Ticket (same, but with a visible ticket for gatekeeper verification). Paid tickets are coming in a future update.
  • Allow Transfers: Pass holders can transfer their pass to another room member (off by default).
  • Allow Non-Members: People who are not yet room members can acquire a pass and are added as temporary guests. (Coming in a future update.)

๐Ÿ‘คThe attendee experience

When someone visits an event that requires a pass, the event detail page shows a "Get Pass" button instead of the usual RSVP buttons.

1

Claim a pass

Clicking Get Pass creates a pass record and assigns a unique verification code. If the event has a capacity limit, passes are first-come first-served.

2

View your pass

After claiming, a View Pass button appears. The pass page shows:

  • Your name and room membership badge
  • Event name, date, time, and location (or Join Meeting button for virtual events)
  • Your verification code in large, readable text (e.g. EVT-A7K3)
  • A QR code placeholder (real QR codes in a future update)
  • Pass type and status
3

At the door (physical event)

Show your pass to the gatekeeper. They will type your verification code into their gatekeeper screen, verify your identity and membership, and tap Admit to check you in.

4

Joining a virtual event

For virtual events, the pass page shows a Join Meeting button instead of a location. This button only appears within 15 minutes of the event start time. The meeting URL is never shown as plain text โ€” you must have a valid pass to access it.

๐Ÿ’กThis prevents meeting link sharing. Only people who claimed a pass can join the virtual event through the pass page.
5

Cancel your pass

If you can no longer attend, click Cancel Pass on your pass page. This frees your spot so someone else can claim it (if the event is at capacity). You cannot cancel after being checked in.

๐Ÿ‘ฎThe gatekeeper experience

Gatekeepers are the people working the door โ€” OWNERs, MODERATORs, or members with the GATEKEEPER role. They use a special gatekeeper screen to look up passes and admit attendees.

1

Access the gatekeeper screen

On the event detail page, gatekeepers see a Gate button. Click it to open the gatekeeper screen. You can also navigate directly to /study-rooms/[room]/events/[eventId]/gate.

โ„น๏ธOnly OWNER, MODERATOR, and GATEKEEPER roles can access the gatekeeper screen. Regular members see a 404 page.
2

Look up a pass

Type the attendee's verification code (e.g. EVT-A7K3) into the lookup field and press Enter or click Lookup. The system shows:

  • Attendee name and avatar (verify identity visually)
  • Room membership status and how long they have been a member
  • Pass type, status, and group size
  • Whether they have already been admitted (and by whom)
โš ๏ธIf the attendee has been removed from the room since claiming their pass, the lookup shows "Membership revoked โ€” cannot admit." Passes are not valid without current room membership.
3

Admit the attendee

After verifying the attendee's identity, click Admit Attendee. The pass is marked as checked in with a timestamp and your name as the admitting gatekeeper. The live check-in counter updates immediately for all gatekeepers.

4

Track check-in progress

The gatekeeper screen shows a real-time counter and progress bar: "Checked in: 47 / 120." Every admission updates this via Ably, so multiple gatekeepers at different doors stay in sync.

5

Handling group passes

Some passes allow multiple people (group tickets โ€” coming in a future update). The Admit button shows "Admit +1" for each additional person in the group. The pass is marked USED when all group spots are admitted.

๐Ÿ’กDuplicate check-in is prevented.If someone tries to use a code that has already been admitted, the gatekeeper sees "Already admitted at 2:34 PM by Sarah" โ€” this stops people from sharing codes or re-entering.

๐Ÿ›ก๏ธThe GATEKEEPER role

The GATEKEEPER is a dedicated room role for delegating door duty. It lets someone check people in without giving them broader moderator powers.

RoleCan Admit?Can Revoke Passes?Other Powers
OWNERYesYesFull room administration
MODERATORYesYesModerate content, manage members
GATEKEEPERYesNoDoor duty only โ€” no content or member management
MEMBERNoNoStandard member access

To promote a member to GATEKEEPER, go to Room Settings > Members, find the member, and change their role. They will immediately be able to access the Gate button on any event in the room.

๐ŸšซRevoking passes

Owners and moderators can revoke a pass if someone should no longer attend (misconduct, duplicate registration, at the attendee's request, etc.). Gatekeepers cannot revoke passes โ€” they can only admit.

To revoke a pass, use the revocation API or admin interface. The revoker must select a required reason from:

  • Violation of Conduct โ€” attendee broke room rules
  • Payment Issue โ€” for paid tickets (future)
  • At Attendee Request โ€” they asked to be removed
  • Duplicate Registration โ€” same person claimed multiple passes
  • Other โ€” with an optional free-text note

The revocation reason is stored on the pass record and visible in the admin audit trail. It is included in the revocation notification email (coming in a future update).

โš ๏ธA checked-in pass cannot be refunded or revoked (for paid events in the future). The revoke action is only available for passes that have not yet been used at the door.

๐Ÿ“ŠCapacity limits and full events

When creating an event, you can set a maximum attendee count (the same maxAttendees field used by RSVP). Door Pass respects this limit.

When the limit is reached, the "Get Pass" button changes to show the event is full. In a future update, a waitlist will let people queue for spots that open up when someone cancels.

โ„น๏ธCapacity count includes only ACTIVE passes. Cancelled and revoked passes are not counted โ€” they free up slots immediately.

๐Ÿ“‹Quick Reference

ActionWho Can Do It
Enable Door Pass for the roomRoom owner only
Create an event requiring passesOwner, moderator (or member if events are not moderator-only)
Claim a passAny active room member
Cancel own passPass holder
Admit attendees at the doorOwner, moderator, gatekeeper
Revoke a passOwner, moderator (with required reason)
Promote a member to GatekeeperRoom owner