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

​
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.
On macOS, you can also use keyboard shortcuts:
  • Press Cmd+Enter on a toggle to expand/collapse it
  • Navigate between toggles with arrow keys

​
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.

​
Toggle Tips and Best Practices

Use descriptive titles: Since the title is the only part that’s always visible, make it clear what’s inside. Don’t overuse: Too many toggles can make a document feel like a maze. Use them for genuinely optional content. Consider your audience: If sharing a document, think about what should be expanded by default. Important information should be visible without extra clicks. Combine with other features: Toggles work well with:
  • Cards and pages for visual organization
  • Lists for structured content
  • Headers for document sections

​
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 vs Pages

Use Toggles when:
  • You want content to be hidden but quickly accessible
  • The content is optional or reference material
  • You’re creating FAQ or help documentation
  • You want to keep related information in one view
Use Pages when:
  • The content deserves its own dedicated space
  • You need to navigate to it separately
  • The content is substantial and self-contained
  • You want to build a hierarchical knowledge base

​
Common Use Cases

Meeting Notes
  • Main agenda items as visible text
  • Discussion notes hidden in toggles
Project Documentation
  • Overview always visible
  • Technical details in toggles
Learning Materials
  • Questions visible
  • Answers hidden in toggles until needed
Reference Documents
  • Key points visible
  • Supporting details in toggles

Blocks and Pages

Document Styling

Collections