ReportLog
Documentation menu

Roles

Who may do what on a site, who may appoint whom, and why one kind of administrator cannot make more of itself.

A person holds one site-wide role, plus any number of organization roles and flags.

RoleWhat it is for
OwnerThe one person at the top of a site. Everything an administrator can do, and also: appoints and removes administrators, vets journalists, takes backups and exports, resets other people's second factor, hands the seat over.
AdministratorRuns the site: logbooks, lists, maps, files, settings, wording, legal notices, records. Can moderate, after accepting the moderator agreement.
Access ManagerAppoints and removes moderators, manages organizations and their people.
ModeratorDecides what is published. See the moderation queue.
JournalistReads the journalist desk. Vetted by the owner. See Journalists.
Signed-in personAnybody with an account: a reporter looking at their reports, a subscriber to email updates.

Who may appoint whom#

This table is read from the code (MAY_GRANT in packages/access), so it is always the one the site enforces:

RoleMay appoint
OwnerModerator, Access Manager, Administrator, Journalist
AdministratorModerator, Access Manager
Access ManagerModerator
ModeratorNobody
JournalistNobody
Signed-in personNobody

The ceiling. An Access Manager can appoint moderators and cannot appoint Access Managers; an administrator can appoint Access Managers and cannot appoint administrators. So neither role can spread on its own. Only the owner appoints or removes an administrator, and only the owner changes a journalist.

The owner's seat cannot be granted. It is in no row of that table, its own included, so no appointment can produce a second owner. It moves only by a handover: the owner offers it to somebody by email, with a code; that person accepts; the outgoing owner becomes an administrator. The setup wizard seats the first owner.

Rank. The owner counts as an administrator. Nothing else outranks anything: an administrator is not a moderator by rank, but administrators may work in the moderation screens once they have accepted the moderator agreement.

Organization roles#

Inside an organization, a person is a manager or a coordinator. These sit beside a site-wide role, not instead of it.

Flags#

Two flags, given by Access Managers, administrators and the owner:

Where it is done#

See this page's source