Skip to main content

Link element

This is a rich text element, compatible only with the rich_text block. It must be used within the rich_text_list, rich_text_quote, or rich_text_section block element within the rich_text block's elements array.

Fields​

FieldTypeDescriptionRequired?
typeStringThe type of object; in this case "link".Required
urlStringThe link's url.Required
textStringThe text shown to the user (instead of the url). If no text is provided, the url is used.Optional
unsafeBooleanIndicates whether the link is safe.Optional
from_llmBooleanIndicates whether the link was generated by the LLM itself.Optional
is_slack_urlBooleanIndicates whether the link is a Slack URL.Optional
truncatedBooleanIndicates whether the link has been truncated.Optional
styleObjectAn object of optional boolean properties that dictate style: bold, italic, strike, highlight, client_highlight, underline, and unlink.Optional

Example​

{
    "blocks": [
        {
            "type": "rich_text",
            "elements": [
                {
                    "type": "rich_text_section",
                    "elements": [
                        {
                            "type": "link",
                            "url": "https://docs.slack.dev"
                        }
                    ]
                }
            ]
        }
    ]
}

View in Block Kit Builder