--- title: "Understanding Block Types" description: "Explore the Block editor's toolbox of building blocks for articles—from text and media to tables and buttons. Use slash commands (type /) to access all available blocks." url: "https://support.helpdocs.io/article/kr7prvv938-understanding-block-types" category: "Using the Text Editor" updated_at: "2026-09-12T10:40:13Z" --- # Understanding Block Types The block editor gives you a toolbox full of building blocks for your articles. Each one does something a little different, from plain text to interactive callouts. Let's break down the blocks you'll reach for most so you know exactly which one to use. 🧱 This article refers to our [new Block editor](/article/tb3ldgvw0b-introduction-to-the-block-editor). Older articles may use our [Classic text editor](https://support.helpdocs.io/category/9ceur1b2ck-legacy-editor). You can upgrade an older article to the new Block editor at any time in the article's ⋯ More menu, or contact support to upgrade all articles at once. Type `/` anywhere in an article to bring up the slash command menu and see all the blocks available to you. ### Text Blocks | Icon | Block Name | What It's For | Slash Command(s) | |-----------------------------------------------------------------------------------------------------------------------|----------------|----------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------| | ![](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788888825612/text.svg) | Paragraph | The default text block for regular body copy | `/text` or `/paragraph` | | ![Large heading block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788884557063/headin.svg) | Large Heading | For major section breaks | `/heading` or `/h1` | | ![Medium heading block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788884578108/headin.svg) | Medium Heading | For subsections | `/h2` | | ![Small heading block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788884586245/headin.svg) | Small Heading | For smaller subsections within your content | `/h3` | | ![Bullet list block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788884613766/bullet-list.svg) | Bullet List | Unordered items | `/list`, `/bullet`, or `/ul` | | ![Numbered list block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788884626946/numbered-list.svg) | Numbered List | Ordered items, perfect for step by step instructions | `/numbered` or `/ol` | | ![Callout block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788887962980/callout.svg) | Callout | Helps important information stand out from the rest of your copy. Choose from Note, Tip, or Warning | `/callout`, `/tip`, `/note`, or `/warning` | | ![Quote block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788888162113/quote.svg) | Quote | Visually sets apart something someone else said from your own writing. Press **Shift + Enter** inside it to add extra paragraphs | `/quote` | | ![Code block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788888171574/code.svg) | Code Block | Adds syntax highlighted code snippets. Highlighting shows up when the article is viewed, not while you're editing | `/code` | | ![Markdown block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788888182076/markdown.svg) | Markdown Block | Write whole sections using GitHub-flavored Markdown. It transforms into HTML when previewed | `/markdown` | ### Media & Embeds Icon Block Name What It's For Slash Command(s) ![Image block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788888192688/image.svg) Image Upload or embed an image `/image` ![Embed block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788888207458/embed.svg) Embed / Video Drop in external content like YouTube, [Arcade](/article/bvue88o34z-embedding-arcades), Vimeo, or Spotify. You can also just paste in your link and it'll expand! ✨ `/embed` or `/video` ![File block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788888330855/file.svg) File Attach files under 5MB directly to your article `/file` ### Layout & Advanced Blocks | Icon | Block Name | What It's For | Slash Command(s) | |-----------------------------------------------------------------------------------------------------------|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------| | ![Table block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788888345847/table.svg) | Table | Organize data into neat rows and columns. Click the border of a table to reveal plus icons for adding rows or columns, and hover over a row or column to reveal a red X for deleting it | `/table` | | ![Divider block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788888354639/divider.svg) | Divider | Add a horizontal rule to visually separate sections | `/divider` or `/hr` | | ![Fold block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1789208527229/fold.svg) | Fold | Hide a section behind a summary line your reader clicks to expand. Great for optional detail, long examples, or FAQ style content | `/fold`, `/toggle`, or `/accordion` | | ![Button block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788888362814/button.svg) | Button | Insert a clickable button, handy for linking to another page or resource | `/button` | | ![HTML block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788888371724/html.svg) | HTML Block | For when you need full control, paste raw HTML | `/html` | | ![Clip block icon](https://files.helpdocs.io/Ytt2uahFxY/articles/kr7prvv938/1788888379192/clip.svg) | Clip | Insert reusable content you've saved as a [Clip](/article/m27mmeeghp-understanding-clips). Update the Clip once and it updates everywhere it's used | `/clip` | Want to become a slash command pro? Check out [**Shortcuts in the Block Editor**](https://support.helpdocs.io/article/qsuih77eq7-shortcuts-in-the-block-editor) for the full list of keyboard shortcuts and markdown patterns.