Toggles

Learn how to use toggles to collapse and expand content blocks, keeping your documents clean and organized.

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

Understanding Craft’s structure

Document Styling

Format and style your content

Collections

Database-like features for structured data