Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

document application command format #5186

Merged
merged 4 commits into from
Aug 22, 2022
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
25 changes: 14 additions & 11 deletions docs/Reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -253,24 +253,27 @@ Discord utilizes a subset of markdown for rendering message content on its clien

###### Formats

| Type | Structure | Example |
| ----------------------- | ------------------- | ---------------------------- |
| User | <@USER_ID> | <@80351110224678912> |
| User \* | <@!USER_ID> | <@!80351110224678912> |
| Channel | <#CHANNEL_ID> | <#103735883630395392> |
| Role | <@&ROLE_ID> | <@&165511591545143296> |
| Standard Emoji | Unicode Characters | 💯 |
| Custom Emoji | <:NAME:ID> | <:mmLol:216154654256398347> |
| Custom Emoji (Animated) | <a:NAME:ID> | <a:b1nzy:392938283556143104> |
| Unix Timestamp | <t:TIMESTAMP> | <t:1618953630> |
| Unix Timestamp (Styled) | <t:TIMESTAMP:STYLE> | <t:1618953630:d> |
| Type | Structure | Example |
| ------------------------ | ------------------- | ----------------------------- |
| User | <@USER_ID> | <@80351110224678912> |
| User \* | <@!USER_ID> | <@!80351110224678912> |
| Channel | <#CHANNEL_ID> | <#103735883630395392> |
| Role | <@&ROLE_ID> | <@&165511591545143296> |
| Slash Command \*\* | </NAME:COMMAND_ID> | </airhorn:816437322781949972> |
| Standard Emoji | Unicode Characters | 💯 |
| Custom Emoji | <:NAME:ID> | <:mmLol:216154654256398347> |
| Custom Emoji (Animated) | <a:NAME:ID> | <a:b1nzy:392938283556143104> |
| Unix Timestamp | <t:TIMESTAMP> | <t:1618953630> |
| Unix Timestamp (Styled) | <t:TIMESTAMP:STYLE> | <t:1618953630:d> |

Using the markdown for either users, roles, or channels will usually mention the target(s) accordingly, but this can be suppressed using the `allowed_mentions` parameter when creating a message. Standard emoji are currently rendered using [Twemoji](https://twemoji.twitter.com/) for Desktop/Android and Apple's native emoji on iOS.

Timestamps are expressed in seconds and display the given timestamp in the user's timezone and locale.

\* User mentions with an exclamation mark are deprecated and should be handled like any other user mention.

\*\* Subcommands and subcommand groups can also be mentioned by using respectively `</NAME SUBCOMMAND:ID>` and `</NAME SUBCOMMAND_GROUP SUBCOMMAND:ID>`.

###### Timestamp Styles

| Style | Example Output | Description |
Expand Down