Skip to main content
Toggles are a powerful way to hide and reveal content in your documents. They help you keep your workspace clean and focused by allowing you to collapse sections you’re not actively working on.

​
What Are Toggles?

A toggle is a collapsible block that can hide or show its nested content. Think of it like an accordion or dropdown section – you can click to expand and see what’s inside, or collapse it to save space. Toggles are perfect for:
  • Hiding detailed information that’s not always needed
  • Creating FAQ-style documents
  • Keeping reference material accessible but out of the way
  • Managing long documents with many sections
  • Creating cleaner presentations and shared documents

​
Creating a Toggle

There are several ways to create a toggle in Craft:

​
Using the Slash Menu

1
Type / to open the slash menu
2
Search for “toggle” or scroll to find it
3
Select “Toggle” from the menu
4
Type your toggle title (the part that’s always visible)
5
Press Enter to create content inside the toggle

​
Using the Markdown Shortcut

If you prefer to keep your hands on the keyboard, you can turn a block into a toggle as you type:
1
Place your cursor at the start of an empty block
2
Type a plus sign (+) followed by a space
The block instantly becomes a toggle, and the + characters are removed. Type your toggle title, then press Enter to add content inside.
This is the same shortcut style Craft uses for other blocks, like - and space for a bulleted list or 1. and space for a numbered list.

​
Converting Existing Content

You can turn any block with nested content into a toggle:
1
Click on the block that contains nested content
2
Right-click (or use the block menu)
3
Select “Convert to Toggle”
The block becomes a toggle with all its nested content hidden by default.

​
Expanding and Collapsing Toggles

To expand a toggle: Click the arrow icon (▶) next to the toggle title. The arrow rotates down (▼) and the content appears. To collapse a toggle: Click the arrow icon again to hide the content.
  • Turn the current block into a toggle: Cmd+Option+7 (macOS) or Ctrl+Shift+7 (Windows)
  • Expand or collapse every toggle in the document at once: Cmd+Option+T (macOS) or Ctrl+Alt+T (Windows)

​
Working with Nested Toggles

Toggles can contain other toggles, creating multiple levels of collapsible content. This is useful for creating hierarchical information structures: 
▶ Project Overview
  ▶ Phase 1: Planning
    - Requirements gathering
    - Stakeholder meetings
  ▶ Phase 2: Development
    - Sprint 1
    - Sprint 2
Each toggle level can be independently expanded or collapsed.

​
Tips and Best Practices

  • Use descriptive titles. The title is the only part that’s always visible, so make it clear what’s inside.
  • Don’t overuse them. Too many toggles can make a document feel like a maze. Save them for genuinely optional content.
  • Think about what’s visible when sharing. Important information should be readable without extra clicks.
  • Combine with other features. Toggles work well alongside cards, lists, and headers to structure a document.

​
Converting Back to Regular Blocks

If you decide you don’t want a toggle anymore:
1
Expand the toggle so you can see its content
2
Right-click on the toggle block
3
Select “Convert to Regular Block” (or use Ungroup)
The content will remain but will always be visible.

​
When to Use Toggles

Reach for a toggle when you want content hidden but quickly accessible in the same view, such as optional or reference material, FAQ answers, or supporting detail. A few common patterns:
  • Meeting notes: agenda items stay visible, discussion notes tuck into toggles
  • Project docs: the overview is always visible, technical details sit in toggles
  • Learning materials: questions are visible, answers stay hidden until needed
Use a page instead when the content deserves its own dedicated space to navigate to, is substantial and self-contained, or belongs in a deeper, hierarchical structure.

Blocks and Pages

Understanding Craft’s structure

Document Styling

Format and style your content

Collections

Database-like features for structured data