Documentation / Notifications / Highlights Overview
On this page
Overview The three commands The Highlights Page The collective toggle Locked without Premium The active highlights list Removing a highlight When Premium lapses How the DM alerts work When a DM cannot be delivered Limits & Edge Cases Command Reference

Highlights — Overview Premium

Let your members receive a DM the moment a word or phrase they care about is said in a watched channel — a keyword DM alert system for the whole server.

Overview

Highlights are a Mokito Premium feature. When a member adds a highlight, they pick a word or phrase and a single channel. From then on, whenever that phrase appears in a message in that channel, Mokito sends the member a private DM with a link straight to the message — so they never miss the conversations they care about, even in busy servers.

Each highlight is scoped to one channel. A member can watch the same phrase in several channels by adding a highlight per channel, and can watch different phrases in the same channel by adding a highlight per phrase.

Highlights live under Notifications → Highlights in the guild dashboard. Only the server owner and managers can change the server-wide toggle and remove other members' highlights; members manage their own highlights from Discord.

The three commands

Members interact with highlights entirely from Discord using three slash commands. There is no in-Discord setup step on the web panel for individual highlights — members add, list, and remove their own.

CommandWhat it does
/highlightAdd a new keyword DM alert for a phrase in a channel.
/highlight-listShow your active highlights in the current server.
/highlight-removeRemove one of your highlights by its ID.

For the full argument reference and example responses, see the Command Reference page.

The Highlights Page

The Notifications → Highlights page in the guild dashboard has two parts: a collective toggle that controls all three commands at once, and a list of every active highlight in the server that owners and managers can review and remove.

The collective toggle

Unlike fun and reminder commands, highlights use a single collective toggle. Turning it off disables /highlight, /highlight-list, and /highlight-remove together — you cannot turn individual commands on or off separately. The toggle defaults to on.

When the toggle is off, members who try to use any highlight command see an ephemeral message: "Highlights are currently disabled in this server." Existing highlights are kept; they just stop producing DM alerts until the toggle is turned back on.

Locked without Premium

The toggle is locked when the server does not have Mokito Premium. The on/off radios are greyed out and the save button is disabled, with a note explaining that highlights are a Premium feature. Existing highlights are preserved underneath the lock, but the bot will not process them.

The active highlights list

Below the toggle, the page lists every active highlight in the server, newest first, with the watcher's avatar and display name, the phrase, the watched channel, the 7-character highlight ID, and how long ago it was created. This list is read-only for owners and managers except for the Remove button on each row.

Each ID has a small copy button so you can grab it for /highlight-remove without retyping it.

Removing a highlight

Owners and managers can remove any member's highlight from this page. Removing a highlight opens a confirmation modal showing the phrase and the watcher's name; confirm to delete. The member is not notified. Removing a highlight cannot be undone, but the member can re-add it at any time (subject to the per-member limit).

When Premium lapses

If the server's Premium subscription lapses, highlights behave gracefully:

How the DM alerts work

Once a highlight is active, Mokito watches messages in the chosen channel for the phrase. Matching is case-insensitive and works on substrings — if a member watches raid, a message saying "Anyone up for a raid tonight?" triggers the alert, and so does "We raided the dungeon."

When a match is found, Mokito sends the watcher a DM containing an embed with:

Only text and announcement channels. Highlights can only watch ordinary text channels and announcement channels. Threads, voice channels, stage channels, forum channels, and category channels cannot be watched. The channel option in /highlight only lets members pick from text and announcement channels.
You are never alerted to your own messages. If you watch a phrase and you type it yourself, you do not get a DM — only messages from other people trigger your highlights. Bot messages are also skipped.

When a DM cannot be delivered

If a member has disabled DMs from non-friends (or from the server), Mokito cannot deliver the highlight DM. The match still happens, but the DM silently fails. Mokito does not retry or post the alert in the channel instead — the member simply won't see it. Members who want reliable highlight alerts should allow DMs from the server.

Limits & Edge Cases

LimitValue
Active highlights per member5. Owners and managers are exempt and can exceed this limit.
Phrase length1–100 characters. Whitespace is collapsed; leading/trailing whitespace is trimmed.
Highlight ID7 characters, drawn from a–z, A–Z, 0–9, and dashes. Shown by /highlight-list and on the web panel.
Duplicate phrase + channelNot allowed — you can't watch the same phrase in the same channel twice. Watch the same phrase in a different channel, or a different phrase in the same channel, instead.
MatchingCase-insensitive substring match. raid matches "raid", "Raider", "brainstorm" (contains "raid"), etc.
Watched channel typesText channels and announcement channels only.
Self-messagesSkipped — you are never alerted to your own messages.
Bot messagesSkipped.
Per-server scopeHighlights belong to the server they were created in. A highlight in one server does not fire in another.
Premium requiredAll three commands and the DM alerts require Mokito Premium. Without Premium, commands return an ephemeral Premium message and no DMs are sent.

Command Reference

For the full list of arguments, example invocations, and the exact responses each command returns, see the Command Reference page.