Rich text list element | Slack Developer Docs reference Skip to main content Guides Reference Samples Tools Changelog Dev Program MANAGE APPS * Reference * App manifest * Block Kit * Overview * Blocks * Block Kit Elements * Overview * Attachment mention element * Broadcast element * Button element * Canvas element * Canvas message unfurl element * Canvas user mention element * Channel element * Checkboxes element * Citation element * Color element * Date element * Date picker element * Datetime picker element * Email input element * Emoji element * Feedback buttons element * File element * File input element * Icon button element * Image element * Link element * List record element * Message mention element * Multi-select menu element * Number input element * Overflow menu element * Plain-text input element * Radio button group element * Rich text input element * Rich text list element * Rich text preformatted element * Rich text quote element * Rich text section element * Salesforce data field element * Select menu element * Tag element * Team element * Text element * Time picker element * URL input element * URL source element * User element * Usergroup element * Work object mention element * Workflow button element * Workflow mention element * Composition objects * Events * Interaction payloads * Methods * Objects * Scopes * Types * Slack Connect API * Views * * Audit Logs API * Legal Holds API * SCIM API * * Slack Status API * * Block Kit * Block Kit Elements * Rich text list element Copy as markdown On this page Rich text list element Fields ​ Field Type Description Required? type String The type of sub-element; in this case, rich_text_list . Required style String Either bullet or ordered , the latter meaning a numbered list. Required elements Object [] An array of rich_text_section objects containing two properties: type , which is "rich_text_section", and elements , which is an array of rich text elements. Rich text elements include attachment_mention , broadcast , canvas , canvas_user_mention , canvas_message_unfurl , channel , citation , color , date , emoji , file , link , list_record , message_mention , salesforce_data_field , tag , team , text , user , usergroup , work_object_mention , workflow_mention . Required indent Number Sub-list indent level. Optional offset Number Number to offset the first number in the list. For example, if the offset = 4 , the first number in the ordered list would be 5. Optional border Number Turn the border on or off. Optional Example ​ * JSON * Python Slack SDK * Node Slack SDK * Java Slack SDK { "blocks" : [ { "type" : "rich_text" , "block_id" : "block1" , "elements" : [ { "type" : "rich_text_section" , "elements" : [ { "type" : "text" , "text" : "My favorite Slack features (in no particular order):" } ] } , { "type" : "rich_text_list" , "elements" : [ { "type" : "rich_text_section" , "elements" : [ { "type" : "text" , "text" : "Huddles" } ] } , { "type" : "rich_text_section" , "elements" : [ { "type" : "text" , "text" : "Canvas" } ] } , { "type" : "rich_text_section" , "elements" : [ { "type" : "text" , "text" : "Developing with Block Kit" } ] } ] , "style" : "bullet" , "indent" : 0 , "border" : 1 } ] } ] } View in Block Kit Builder block-kit/src/elements/rich_text_list.py loading . . . View on GitHub block-kit/src/elements/rich_text_list.js loading ... View on GitHub block-kit/src/main/java/elements/RichTextList.java loading . . . View on GitHub Let's say we want to create a nested list, for example something that looks like this: Breakfast foods I enjoy: * Hashbrowns * Eggs * Scrambled * Over easy * Pancakes, extra syrup To create that in rich text, create three instances of rich_text_list , the middle one using the indent property to indent the types of eggs into that sub-list. * JSON * Python Slack SDK * Node Slack SDK * Java Slack SDK { "blocks" : [ { "type" : "rich_text" , "block_id" : "block1" , "elements" : [ { "type" : "rich_text_section" , "elements" : [ { "type" : "text" , "text" : "Breakfast foods I enjoy:" } ] } , { "type" : "rich_text_list" , "style" : "bullet" , "elements" : [ { "type" : "rich_text_section" , "elements" : [ { "type" : "text" , "text" : "Hashbrowns" } ] } , { "type" : "rich_text_section" , "elements" : [ { "type" : "text" , "text" : "Eggs" } ] } ] } , { "type" : "rich_text_list" , "style" : "bullet" , "indent" : 1 , "elements" : [ { "type" : "rich_text_section" , "elements" : [ { "type" : "text" , "text" : "Scrambled" } ] } , { "type" : "rich_text_section" , "elements" : [ { "type" : "text" , "text" : "Over easy" } ] } ] } , { "type" : "rich_text_list" , "style" : "bullet" , "elements" : [ { "type" : "rich_text_section" , "elements" : [ { "type" : "text" , "text" : "Pancakes, extra syrup" } ] } ] } ] } ] } View in Block Kit Builder block-kit/src/elements/rich_text_list.py loading . . . View on GitHub block-kit/src/elements/rich_text_list.js loading ... View on GitHub block-kit/src/main/java/elements/RichTextList.java loading . . . View on GitHub Previous Rich text input element Next Rich text preformatted element Copy as markdown * Fields * Example . * Tools * Slack CLI * Bolt frameworks * Slack SDKs * Block Kit Builder * Developer program * Code samples & tutorials * LLM? Read llms.txt * All tools Learn * Learning paths * Workshops * Slack certifications * Trailhead * Resource library * All learning resources Community * Slack community * Slack events Resources * Docs * Blog * Slack marketplace * Developer newsletter Manage Apps * Your apps * Status * Privacy * Terms * Cookie Preferences * Support * Changelog * Your Privacy Choices © 2026 Slack Technologies, LLC, a Salesforce company. All rights reserved. Various trademarks held by their respective owners. * * *