Back to Home

Understanding Magic Links

Tabletop Time uses a passwordless authentication system. Instead of usernames and passwords, we use secure "Magic Links" sent to your Telegram or Discord to verify your identity.

Why no passwords?

We believe you shouldn't need another password for a tool you use once a week. By verifying ownership of your Telegram/Discord account, we can prove it's you without storing sensitive credentials.

Use Case 1: Sync & Recover (My Events)

Best for: Logging in to view all your events at once.

If you are on a new device or your cookies have been cleared, you can recover access to your entire event history via the My Events (Profile) page.

  1. Navigate to the My Events page.
  2. Scroll down to the "Sync & Recover" section.
  3. Enter your Telegram Handle (e.g., @YourHandle) or Discord Username.
  4. Click Sync My Events.
  5. The bot will DM you a Global Magic Link. Click it to log in.

This will restore your Event List and your Voting Identity (allowing you to edit previous votes).


Use Case 2: Manager Recovery

Best for: Quickly switching devices for a specific event.

Viewing your event's Manage Page and want to switch to your phone?

  1. On the Manage Page, look for the Manager Recovery box.
  2. Click "Send Magic Link".
  3. The bot will send a specific Event Admin Link to your DMs.
  4. Clicking this grants admin access only for that specific event.

Use Case 3: I'm Locked Out

Best for: Recovering access when cookies are gone.

If you are viewing an event you created but appear as a Participant (no admin controls):

  1. Scroll to the bottom of the Vote Page.
  2. Click: "Are you the organizer? Manage this event".
  3. Click the small link: "Lost Manager Link?".
  4. Enter your Telegram Handle.
  5. If it matches our records, we send a secure link to your DMs.

Technical Insight

We use two layers of storage: Cookies (for secure, 30-day server auth) and LocalStorage (to auto-fill your name and remember your specific votes on a device). Magic Links restore both.