Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Roles and permissions

Everyone has a role, and a role is a set of permissions. Logged-out visitors have the Anonymous role. Edit roles under Admin → Roles: rename them, and choose their permissions. You can only hand on permissions you have yourself; ones you lack stay as they are.

Adding roles

Add a role at the bottom of Admin → Roles with a name, a rank below your own, and optionally the permissions of an existing role to start from. The ranks of added roles can be changed later, and they can be deleted, which moves their users to a role you choose. The built-in roles can’t be deleted and keep their ranks.

PermissionAllows
View postsseeing posts, tags and profiles; take it from Anonymous for a private site
Uploaduploading posts
Upload without approvalskipping the approval queue, when it’s on
Edit posts and tagschanging a post’s tags, rating, source, description and parent; requesting aliases and implications
Favorite, Votefavoriting posts; voting on posts and comments
Commentposting comments, and editing and deleting your own
Edit the wiki and artists
Mass edit tagsadding and removing tags on every post a search finds (Moderation → Mass edit)
Lock posts and change locked oneslocking a post’s rating, tags, notes or status, and changing them anyway
Undo a user’s post editstaking back every post edit a user made in a range of days (Moderation → Post changes)
Replace posts’ filesswapping a post’s file for a better one, keeping everything else (Posts and files)
Edit notesadding, moving, changing and deleting notes on posts
Create and edit poolsmaking pools, and changing their posts, names and descriptions (deleting a pool takes Delete and restore posts)
Flag postsasking moderators to delete a post
Approve posts and handle flagsthe approval and flag queues
Delete and restore posts
Purge postsremoving deleted posts and their files for good
Manage tags, aliases and implicationstag categories, deprecating tags, deciding alias and implication requests
See deleted postsdeleted posts and comments
Hide comments and handle reports about themhiding and restoring anyone’s comments, and the reported comments queue
Ban users and networks
Manage userschanging other users’ roles and account status
Manage site settings and roles
Read the moderation log

The built-in roles and what they start with:

RoleRankPermissions
Anonymous0View posts
Member10Anonymous, plus Upload, Edit posts and tags, Comment, Favorite, Vote, Flag posts, Edit the wiki and artists, Create and edit pools, Edit notes
Contributor20Member, plus Upload without approval
Janitor30Contributor, plus Approve posts, Delete and restore posts, Manage tags, See deleted posts, Hide comments
Moderator40Janitor, plus Ban users and networks, Read the moderation log, Mass edit tags, Lock posts, Undo a user’s post edits, Replace posts’ files
Admin50everything

Upload limits

Each role can limit uploads, under Admin → Roles (empty means no limit):

  • Waiting for approval at once: when the approval queue is on, how many of a user’s uploads may wait in it. Members start at 10. Roles with Upload without approval skip the queue, so this doesn’t apply to them.
  • Per day: uploads in the last 24 hours, queued or not.

With Limits on uploads waiting for approval grow… ticked in the site settings, the queue limit follows each user’s record, as on Danbooru: one more for every 10 of their uploads that were approved, one fewer for every 5 that were deleted, from 1 up to four times the role’s limit.

The upload page tells users how many uploads they have left, and why an upload was refused; the API’s /users/me says the same under uploads.

Automatic promotion

With Automatic promotion ticked in the site settings, members become contributors (who upload without approval) once their record is good enough. Every hour, members are promoted who have at least the set number of approved uploads and post edits, have been registered for the set number of days, and have had at most the set number of uploads deleted in the last 30 days. Defaults: 50 uploads, no edits needed, 30 days, no recent deletions.

Banned members aren’t promoted. Staff who manage users can keep someone from automatic promotion with Never promote automatically on their profile. Promotions are in the moderation log, and profiles say when someone was promoted.

Rank

Staff act only on people below them: a moderator can ban members and janitors, but not other moderators or admins. The same goes for changing roles: you can give or take away only roles ranked below your own that grant nothing you lack, and never change your own role or status. That keeps a mistake, or a compromised account, from locking out the people above it.

From the shell, moekura admin set-role NAME ROLE changes anyone’s role, which is how you recover if the last admin loses access.