Fjord Documentation
01
Welcome new members, say goodbye to departing users and automatically assign roles when they join.
02
AutoMod detects unwanted content and responds according to your server rules.
AutoMod lets you decide which messages are allowed on your server. Ten filters check things such as invites, links, spam and mentions. Set the role and channel scope for each filter. Fjord can delete offending messages and take further action based on the warning level.
The auto-moderator only processes members that Fjord is actually allowed to moderate. The decisive factors are the Discord role order and the required server and channel rights.
“View Channel” is required for filtering. Manage Messages is only required for configured message deletion. The moderation rights are only required if the corresponding consequence is used. “Manage webhooks” is only required for the log channel.
If a member's highest role is at the same level as or above Fjord's highest role, that member is ignored completely. Fjord does not delete the message, issue a warning, apply a timeout, kick, or ban. The same applies if Fjord lacks the general moderation permissions or the permission needed for the configured action.
Server owners and members who Discord does not allow Fjord to moderate due to their roles or permissions also remain unaffected. In these cases, the auto-moderator deliberately does not carry out any partial action.
An activated main switch alone does not filter anything. At least one filter must also be activated and validly configured.
Almost every filter has its own scope. Roles and channels can therefore be treated differently for each filter.
| Mode | Behavior |
|---|---|
| Everywhere except selection | The filter basically applies everywhere or for all roles. Selected channels or roles are excluded. |
| Selection only | The filter only applies to the selected channels or to members with the selected roles. |
The scopes determine where and for whom a filter runs. Discord’s role hierarchy still applies. Selecting a role does not make an otherwise unmoderatable member eligible for moderation.
Each filter is activated individually. The following information fully shows which settings are optional and which must be filled in after activation or in a specific mode.
Detects invitation links to Discord servers.
Turns the detection of Discord invitations on or off.
For "Anywhere except selection", selected channels are excluded. With “Selection only” at least one channel must be selected.
For "Anywhere except selection", selected roles are excluded. With “Selection only” at least one role must be selected.
Blocks images completely or allows them in certain channels in a controlled manner.
Turns the image filter on or off.
Simple blocks images in the selected scope. Advanced works with permitted image channels and quantity limits.
If "Select only" at least one channel to be monitored becomes a mandatory field.
At least one channel must be selected. Pictures can only be sent there.
Allows a value between 1 and 10 images.
Limits an additional 1 to 100 images per user within a period of 5 to 600 seconds. If it is activated, the number and period are mandatory.
Specifies affected or exempt roles in both modes. For Select Only, at least one role is required.
Detects messages with excessive capitalization.
Turns caps lock detection on or off.
The limit for the entire message must be between 50 and 100 percent.
Additionally detects individual fully capitalized sections within normally written messages.
Specifies between 3 and 50 capital letters for a single outlier.
A selection becomes mandatory as soon as “Selection only” is used for the relevant area.
Detects identical content that has been sent repeatedly.
Turns duplicate message detection on or off.
For "Select only" at least one channel must be selected.
For "Select only" at least one role must be selected.
Limits emojis in individual messages and within a time period if desired.
Turns the emoji limit on or off.
Allows a value between 1 and 25 emojis.
Additionally limits 1 to 250 emojis per user. When activated, the number and time slot are mandatory.
The time window must be between 5 and 600 seconds.
A selection becomes mandatory as soon as “Selection only” is used.
Uses a allowlist or block list for links.
Turns the link filter on or off.
“Block all links” treats patterns as permitted exceptions. “Block list only” only blocks the registered patterns.
In “Block all links” mode, the list is optional. In “Block list only” mode, at least one pattern is mandatory. A maximum of 50 patterns are possible, each with a maximum of 255 characters.
A selection becomes mandatory as soon as “Selection only” is used.
Limit member and role mentions per message and optionally within a time period.
Turns the mention limit on or off.
Allows a value between 1 and 9 mentions.
Enable member mentions, role mentions or both. Both types can be counted together.
Additionally limits 1 to 100 mentions per user. When activated, the number and time slot are mandatory.
The time window must be between 5 and 600 seconds.
A selection is required when using “Only selected”.
Limits rapid successive messages.
Turns message spam detection on or off.
Sets between 1 and 10 messages.
Specifies a period between 1 and 60 seconds.
Determines whether the limit counts for each channel separately or together across all filtered channels of the server.
A selection becomes mandatory as soon as “Selection only” is used.
Determines for each role group in which channels these roles may be mentioned.
Turns role mention rules on or off.
If the filter is activated, at least one and a maximum of 25 rules must be created.
For overview purposes only and may contain a maximum of 50 characters.
Each rule requires at least one role. A role may only appear in a single role mention rule.
Each rule requires at least one channel in which the assigned roles can be mentioned.
Determines which member roles are moderated. With “Selection only” at least one role must be selected.
Recognizes heavily combined and difficult to read Unicode characters.
Turns Zalgo text recognition on or off.
For "Select only" at least one channel must be selected.
For "Select only" at least one role must be selected.
You can configure between one and ten warning levels and change their order. At each stage it is determined separately whether the triggering message is deleted and what the consequences will be.
Set a separate expiration period for each warning level in hours, days or weeks. Without configuration, the default is one year (365 days); the allowed range is one hour to 365 days. This period applies to new automatic warnings and /warn. Moving a warning level keeps its expiration period, consequence and message deletion together. The database automatically removes expired warnings from active warning records; they no longer count as active warnings.
The expiration date is fixed when a warning is issued. For warnings already stored with an expiration date, it cannot later be shortened or extended. Dashboard changes apply only to warnings issued afterwards. Older warnings without an expiration date do not receive one retroactively and can still be removed by authorized moderators. Warning expiration is independent of a Discord timeout, kick or ban.
| Consequence | Behavior | Required prerequisite |
|---|---|---|
| None | The warning is counted. Apart from the optional message deletion, there is no sanction. | Fjord must moderate the member and, if necessary, be allowed to manage the message. |
| Timeout | The member receives a timeout of at least 1 minute and a maximum of 28 days. | Right to “moderate members” and a lower member role. |
| Kick | The member is removed from the server and can return via an invitation. | “Kick members” right and a lower member role. |
| Ban | The member is banned from the server. | Right “Ban members” and a lower member role. |
If Fjord cannot reliably perform the moderation configured for a warning level, the user is ignored completely. Fjord does not delete the message, issue a warning or apply a sanction.
The main switch enables or disables the Auto moderator. Logging has its own switch, which you can toggle while the Auto moderator is enabled, whether or not a channel is selected. Turning logging off keeps the selected channel. Selecting “No channel” automatically turns only the logging switch off.
Bot moderation determines whether messages from other bots are checked by the active filters. This does not change Discord permissions or role order.
The optional log channel documents warnings, detected messages and actions taken. Fjord publishes these logs via a webhook rather than as regular bot messages. Choose a channel that Fjord can view and in which Fjord can manage webhooks. The log channel does not replace Discord permissions or enable filters.
| Observation | Examination |
|---|---|
| A particular member is never moderated. | Is their highest role really below the highest Fjord role? Is it the server owner or does it have a non-moderate position? |
| No one is moderated. | Are the main switch and at least one filter active? Does Fjord have the necessary rights and is his role high enough? |
| The filter reacts in the wrong channel. | Check the channel mode “Everywhere except selection” or “Selection only” for each filter. |
| Messages remain. | Is deletion activated for this warning level and is Fjord allowed to manage messages in the channel? |
| There is no timeout, kick or ban. | Check the Discord permission that matches the action and the role order. If moderation is not possible, no warning is generated. |
| No log appears. | Is logging activated, an available channel selected and is Fjord allowed to manage webhooks there? Also check whether the webhook used has been deleted. |
03
Record important events clearly in the Discord channels you choose.
04
Create structured Discord messages in a visual editor without writing JSON.
Members choose their own roles with buttons and select menus. Configure role groups, V1/V2 messages and managed publications.
05
Settings lets you choose the language, time zone and default embed color, delegate dashboard access and manage stored module data.
06
All Fjord slash commands, their permissions and help with errors.