Registration modes & user approval
Getting started
Registration modes & user approval
Control who can create an account on your node. The mode is set in the admin panel at Settings → Site Settings → Registration.
The three modes
| Mode | Behaviour |
|---|---|
| Open | Anyone can register and use the site immediately |
| Approval | New members are blocked until an admin approves them |
| Invite only | Registration requires a valid invitation token |
Default:
Open. ChooseApprovalfor a private or community-first node.
Approval mode
When approval is active:
- A new member registers and verifies their email.
- Their account is created with
pending_approval = true. - They see a "waiting for approval" notice and cannot use the site yet.
- An admin reviews them in the admin panel → People & Access → Users.
- The admin clicks Approve — the member can now log in.
The Users table shows a Pending column; filter by "Pending approval" to see who's waiting.
Invite-only mode
Registration requires an invitation token. Existing members can generate invitations (Invites page) and send them to friends — see the Invites feature in the app.
Environment / fallback
The mode can also be set in .env:
IDENTITY_REGISTRATION=open # open | approval | invitation
The admin-panel setting wins when present. The policy lives in
App\Support\SettingsRegistrationPolicy.
Promoting the first admin
See First-run setup — in approval mode, register first, then
approve + assign the super_admin role from the admin panel (or promote via
tinker).
Related
Still stuck? Contact the node administrator.