You must enable javascript in order to use the Slack API Documentation. You can do this in your browser settings.
Go to Slack

Message guidelines

App messages can make use of some more advanced formatting options, allow your app to build richer interactions that a plain-text message.

Keep formatting simple

Message attachments allow you to add richer formatting to messages, as well as interactive buttons and menus. Try to use the least amount of formatting needed, and remember that messages will look slightly different on mobile devices than they do on a computer screen.

Basic message attachment

How message formatting appears

Message formatting on mobile

Message with thumbnail attachment

Message with thumbnail

Message formatting with thumbnail on mobile

Message with image attachment

Message with image

Message formatting with image on mobile

Don't get too attached

Don't use an attachment when regular message text will suffice, and don't send multiple attachments when a single attachment will do.

And never ever (ever!) send more than 20 attachments.

Like this

Good: Keep it simple

Not like that

Bad: Uh-oh, this is unnecessary

Great: This is one attachment

Good: Limited button selections

Uh-oh: This is three

Bad: Uh-oh too many pieces of flair

The difference is small, yes, but Slack prefers consolidated messages.

Message Attachments as Objects

Each attachment should represent an object so if there's a title for it, it should be inside the attachment.

Good idea

Good: Title in attachment

Bad idea

Bad: Unattached title

Showing a large number of items

Please don't display a long list of items. Try to show the most likely options first and, if you must, use buttons to paginate items. Try to replace the list instead of adding new messages.

Avoid cluttering up the conversation for everyone by using ephemeral messages in conversations when displaying items as an intermediary step of an action.