Docs menu

Access and sharing

Allow and block lists

Let in only certain emails or domains, and keep others out of a room for good.

Where the lists live

Each room has its own lists. Open the room, then Settings, and scroll to Visitor controls → Who can enter. There are two boxes:

Allowed emails and domains
Leave it empty to let in anyone who isn’t blocked. Once it has entries, only matching emails can enter. On an Invite only room, this is the invite list.
Blocked emails and domains
Always refused, even if the same email or domain is also on the allowed list.

Only owners and admins can change the lists.

Set up the lists

  1. Open the room and go to Settings.
  2. Under Who can enter, type emails or domains into either box. Put one per line, or separate them with commas.
  3. Click Save access lists.

When you save, undocsend shows the lists as it stored them, in the cleaned-up form it matches against. If an entry can’t be read as an email or a domain, the save fails and the message names that entry. Each list holds up to 500 entries.

Example: allow acme.com and partner@example.com; block competitor.com.

How entries match

  • Domains cover their subdomains. acme.com also matches mail.acme.com, but never notacme.com. A leading @ or *. is ignored, so @acme.com and *.acme.com mean the same as acme.com.
  • Address variants count as one inbox. name+tag@acme.com is treated as name@acme.com. For Gmail addresses, dots in the name are ignored too. A blocked person can’t get back in by adding a tag.
  • Matching ignores upper and lower case.
  • Block wins. An email on the blocked list is refused even if it, or its domain, is also on the allowed list.

When the lists apply

The lists check an email, so they only apply where the visitor gives one:

  • Anyone with their email and Invite only rooms.
  • Password (shared) rooms with Also collect visitor info turned on.

A Public (no auth) room, or a password room that doesn’t collect visitor info, has no email to check, so the lists don’t apply there. See access modes.

The lists are checked every time a visitor opens something, not only at the gate. If you block someone who is already in, they lose access to the room on their next request.

Share links are separate

The lists guard the room. A share link has its own gate and settings, so the room’s lists don’t apply to it, and a share link never lets anyone into the room. To keep a file from someone, don’t put it on a link they hold, or bind the link to one email. See share links.

What a refused visitor sees

Nothing different. A refused visitor sees the same “check your email” screen as everyone else, but no sign-in link is sent. This way the gate never reveals who is on which list. Each refusal is recorded in the audit log.

Invite only rooms

On an Invite only room, someone who isn’t on the allowed list gets an email saying they don’t have access yet, with a button to request it. A blocked address gets no email at all, and can’t be approved until you remove it from the blocked list. See access requests and pass-along.