Highlights — Command Reference Premium

Every highlight slash command, its arguments, and the response to expect.

Overview

All three highlight commands are implemented and live. Each is Mokito Premium-gated and subject to the collective toggle on the Highlights Overview page. All responses are ephemeral — only the invoking member sees them.

Command	Arguments	What it does
`/highlight`	`phrase` (required), `channel` (required)	Add a new keyword DM alert.
`/highlight-list`	None	List your active highlights in this server.
`/highlight-remove`	`id` (required)	Remove one of your highlights by its ID.

/highlight

Adds a new keyword DM alert for the invoking member. After the highlight is created, Mokito DMs the member whenever the phrase appears in a message in the chosen channel (case-insensitive substring match), subject to the limits on the Limits & Edge Cases section of the overview.

/highlight phrase:raid channel:#general

Arguments

Argument	Type	Required	Description
`phrase`	String	Yes	The word or phrase to watch for. 1–100 characters; whitespace is collapsed and trimmed.
`channel`	Channel	Yes	The channel to watch. Pick from the channel list or paste a channel ID.

Choosing a channel

The channel argument only lists text channels and announcement channels — threads, voice, stage, forum, and category channels cannot be watched. If you paste a channel ID that Mokito hasn't synced yet, or that isn't in the server, you'll see "That channel is not in this server or has not been synced yet."

Example

/highlight phrase:raid channel:#general

Mokito responds (ephemeral embed):

Highlight added
You will be DMed when **raid** is said in **#general**.

ID: aB3-xY9   Active highlights: 1

The ID is the 7-character highlight ID you use with /highlight-remove. The "Active highlights" count is how many active highlights you currently have in this server (toward the per-member limit of 5).

Responses

If the highlight cannot be created, Mokito replies with an ephemeral message instead of an embed. The conditions are:

Condition	Ephemeral response
No Premium on the server	"Highlights are a Mokito Premium feature. Ask the server owner to subscribe to Premium to enable this command."
Collective toggle is off	"Highlights are currently disabled in this server."
Blank phrase	"Please provide a word or phrase to watch for."
Phrase longer than 100 characters	"Phrases must be 100 characters or fewer."
No channel selected	"Please select a channel to watch."
Channel not in the server / not synced	"That channel is not in this server or has not been synced yet."
Already watching that phrase in that channel	"You are already watching for *phrase* in that channel."
5 active highlights reached (non-owner/manager)	"You can only have 5 active highlights at a time. Remove one first, or ask a server owner/manager to add more for you."

Owners and managers bypass the 5-highlight limit. If you own the server or are a manager, /highlight will let you exceed the per-member cap. The limit is enforced only for ordinary members.

/highlight-list

Shows the invoking member's active highlights in the current server as an ephemeral embed. Each line shows the highlight ID, the phrase, and a link to the watched channel, sorted newest first.

/highlight-list

Example

Mokito responds (ephemeral embed, "Your highlights"):

`aB3-xY9` · `raid` in #general
`Kp9-Qw2` · `patch notes` in #announcements

The embed footer reads "Remove with /highlight-remove <id>". Copy the 7-character ID and pass it to /highlight-remove.

If you have no active highlights in this server, Mokito replies: "You have no active highlights in this server. Use /highlight to create one."

/highlight-remove

Removes one of the invoking member's active highlights by its 7-character ID. After removal, the phrase no longer produces DM alerts for that member in that channel. The member can re-add the highlight at any time (subject to the per-member limit).

/highlight-remove id:aB3-xY9

Arguments:

Argument	Type	Required	Description
`id`	String	Yes	The 7-character highlight ID shown by `/highlight-list`. Case-sensitive.

Example

/highlight-remove id:aB3-xY9

Mokito responds (ephemeral):

Highlight removed. You will no longer receive DMs for that phrase.

If the ID doesn't match one of your active highlights, Mokito replies: "No active highlight found with that id." This also happens if the highlight was already removed, or if you mistyped the ID — use /highlight-list to confirm the current IDs.

Owners and managers

Server owners and managers can remove any member's highlight with /highlight-remove, not just their own. The ID still has to be a valid active highlight in this server. Owners and managers can also remove highlights from the active highlights list on the web panel, where every highlight in the server is visible.

Removal is permanent. Removing a highlight cannot be undone. The member is not notified that their highlight was removed; they'll only find out if they run /highlight-list or notice that matching messages no longer produce a DM. The member can re-add the highlight at any time.