Workspace pages are built from blocks. A block can be a simple line of text, a heading, a task list, a table, a media embed, a Board, or a widget.
What blocks are
Blocks let you mix different kinds of content in one page. Add them with /, with Explore more, or from Explore blocks. Some blocks support Block Settings, captions, metadata, comments, or resizing.
Text and writing blocks
| Block | Use it for |
|---|---|
Text | Normal paragraphs and notes. |
Heading 1, Heading 2, Heading 3 | Page structure and collapsible sections. |
Quote | Quoted text, decisions, or highlighted statements. |
Callout | Warnings, context, reminders, and important notes. |
Code Block | Code snippets or formatted technical text. |
Divider | Separating page sections. |
Task and decision blocks
- Use
To-do Listfor simple checklists. - Use
Bulleted ListorNumbered Listfor structured notes. - Use
Quick pollfor quick feedback or voting. - Use
Boardfor draggable groups, cards, assignees, priority, start dates, and due dates. - Use inline buttons such as
Reaction button,Bookmark button, andMention personwhen you need action-style elements inside content.
Media and file blocks
Use Image, File, Video, Audio, and PDF Viewer for uploaded or linked media. Some media blocks can use Vault files, uploads, drag and drop, or pasted links depending on the block.
Data and structure blocks
- Use
Tablefor structured rows and columns. - Use
Table of Contentsto help readers navigate a long page. - Use
2 Columns,3 Columns, or4 Columnsfor side-by-side layouts. - Use
Math Equationfor formulas. - Use
Chartfor visual data. - Use
Mermaid diagramsfor diagrams written in Mermaid syntax.
Embeds and widgets
Workspace includes embed blocks such as Website, Iframe, Calendar, Figma, Adobe Creative Cloud, Google Maps, GitHub Repo, GitHub Issue / PR, Loom Recording, X Post, CodeSandbox, StackBlitz, TradingView, and Weather. Use Iframe for a sandboxed HTTPS web page.
Related guides
- Insert blocks faster:
/guides/workspace/creating-and-editing/use-slash-commands. - Manage block actions:
/guides/workspace/creating-and-editing/format-manage-and-restore-blocks. - Create a Board:
/guides/workspace/workspace-blocks/create-a-kanban-board.
FAQ
How do I add a block? Type /, search for the block, and press Enter. You can also use Explore blocks.
Can every block go inside a Board card? No. Board-related blocks, Table of Contents, and some layout blocks are blocked inside Board cards.
Which blocks should I use for files? Use File for general files, PDF Viewer for PDFs, and Image, Video, or Audio for media-specific display.