DocsBlacklist
Blacklist
Block a member, or a whole role, from opening tickets and using the AI here.
4 commands. Tap one to open it.
- Every plan
Block one user from opening tickets and from talking to the AI in this server.
Options
usermemberrequiredThe user to block
reasontextoptionalWhy they were blocked. The user can be shown this if they appeal.
duration_daysnumberoptionalDays until the block expires by itself (1 to 3650). Leave empty for permanent.
Who can use it
- Manage Server
Manage Server. A block only ever applies to this server.
What happens
A private confirmation with the entry id and when it expires, or that it is permanent. Keep the id: /blacklist remove uses it.
Plan and limits
- Plan
- Works on every plan, Free included.
- How often
- Up to 5 times a minute per person
Good to know
A blocked person is refused when they try to open a ticket, when they use /ai ask, and in your public AI channel. A ticket they already have open is left alone: it is not closed, and the AI keeps answering in it, so close it yourself if that is not what you want. An entry with a duration stops applying the moment it lapses, and lapsed entries are cleared out daily, so the list is not a permanent history of everyone you ever blocked.
When it says no
- That person already has an active block here: remove the old entry first
- This server has reached the 1000-entry limit
- You need Manage Server
- Every plan
Block a role, which blocks every member who holds it.
Options
rolerolerequiredThe role to block. Every member holding it is blocked, including members who get it later.
reasontextoptionalWhy the role was blocked. Shown if a member appeals.
duration_daysnumberoptionalDays until the block expires by itself (1 to 3650). Leave empty for permanent.
Who can use it
- Manage Server
Manage Server. A block only ever applies to this server.
What happens
A private confirmation with the entry id and when it expires, or that it is permanent.
Plan and limits
- Plan
- Works on every plan, Free included.
- How often
- Up to 5 times a minute per person
Good to know
Checked live against the member's current roles, so removing the role from someone unblocks them straight away and giving it to someone blocks them straight away. A member is blocked if their user OR any one of their roles is blocked.
When it says no
- That role already has an active block here
- This server has reached the 1000-entry limit
- You need Manage Server
- Every plan
Lift a block by its entry id.
Options
entry_idnumberrequiredThe entry id shown by /blacklist list (the #12 at the start of each line)
Who can use it
- Manage Server
Manage Server. An id from another server is refused.
What happens
A private confirmation naming the entry that was removed.
Plan and limits
- Plan
- Works on every plan, Free included.
- How often
- Up to 5 times a minute per person
Good to know
Deletes the row. To end a block but keep the record, let a duration_days entry expire instead.
When it says no
- No entry with that id in this server
- You need Manage Server
- Every plan
Show who is blocked in this server, with the entry ids /blacklist remove needs.
Options
usermemberoptionalShow only entries for this one user
active_onlyyes / nooptionalHide entries that have already expired
Default: no
Who can use it
- Manage Server
Manage Server.
What happens
A private list, newest first: the entry id, who is blocked, when it expires, who added it and why. Up to 25 entries at a time, with a count of the rest.
Plan and limits
- Plan
- Works on every plan, Free included.
- How often
- Up to 10 times a minute per person
Good to know
Long reasons are shortened in the embed. Entries whose duration has lapsed are cleared out daily, so they drop off this list shortly after they stop applying.