Documentation / Pinned Messages / Command Reference
On this page
Overview /pin-message Arguments Finding the message ID Example Responses

Pinned Messages — Command Reference Premium

The in-Discord way to pin an existing message to the bottom of its channel.

Overview

The /pin-message slash command lets you pin an existing message in the current channel without opening the web panel. It grabs the message's content and embed, saves them, and posts a copy that Mokito will keep at the bottom of the channel — exactly like a pinned message created from the web panel.

The command is Mokito Premium-gated. On a free server it returns an ephemeral upgrade message. It is subject to the same 10-pinned-message limit per server. See the Pinned Messages Overview for the full feature, the web-panel management, and the limits.

CommandArgumentsWhat it does
/pin-messagemessage (required)Pin an existing message in the current channel so it stays at the bottom.

/pin-message

Pins the message whose ID you provide. The command works in the channel it is invoked in — the message you pin must be in that same channel. Mokito fetches the source message, stores its text and its first embed (if any), and immediately posts a copy that becomes the active pinned message for that channel.

/pin-message message:1147832056789012345

Arguments

ArgumentTypeRequiredDescription
messageStringYesThe message ID of the message to pin. 17–20 characters (a Discord snowflake).

Finding the message ID

To get a message ID in Discord, enable Developer Mode (User Settings → Advanced → Developer Mode), then right-click the message and choose Copy Message ID. Paste that ID into the message argument.

The message must be in the same channel. /pin-message only looks in the channel where you invoke it. If the message ID belongs to a different channel, Mokito replies that it could not find the message.

Example

/pin-message message:1147832056789012345

Mokito responds (ephemeral embed, only visible to you):

Message pinned
That message will now stay pinned to the bottom of this channel.

The pinned copy is posted to the channel immediately, and from then on Mokito keeps it at the bottom by deleting and reposting it whenever another member sends a message in that channel.

Responses

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

ConditionEphemeral response
No Premium on the server"Pinned messages are a Mokito Premium feature. Ask the server owner to subscribe to Premium to use this command."
10 active pinned messages already"This server already has the maximum number of pinned messages."
No message argument provided"Please provide the message ID of the message you want to pin."
Message ID not found in this channel"I could not find that message in this channel. Make sure the message ID is correct and that Mokito can read the channel."
Saved but post failed"I saved the message, but I could not post it to the channel right now. It will be posted the next time someone sends a message there."

All responses are ephemeral — only you see them. The pinned copy itself is a normal message in the channel that every member can see.

Managing a command-pinned message. A pinned message created with /pin-message appears on the pinned messages list in the web panel just like one created from the panel. Owners and managers can edit, resend, or delete it from there.