> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

<iframe src="https://www.youtube-nocookie.com/embed/t7bow8G1sNE" title="Craft Toggles Tutorial" className="w-full aspect-video rounded-xl" allowFullScreen />

## 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

<Steps>
  <Step>
    Type `/` to open the slash menu
  </Step>

  <Step>
    Search for "toggle" or scroll to find it
  </Step>

  <Step>
    Select "Toggle" from the menu
  </Step>

  <Step>
    Type your toggle title (the part that's always visible)
  </Step>

  <Step>
    Press Enter to create content inside the toggle
  </Step>
</Steps>

### 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:

<Steps>
  <Step>
    Place your cursor at the start of an empty block
  </Step>

  <Step>
    Type a plus sign (`+`) followed by a space
  </Step>
</Steps>

The block instantly becomes a toggle, and the `+ ` characters are removed. Type your toggle title, then press Enter to add content inside.

<Tip>
  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.
</Tip>

### Converting Existing Content

You can turn any block with nested content into a toggle:

<Steps>
  <Step>
    Click on the block that contains nested content
  </Step>

  <Step>
    Right-click (or use the block menu)
  </Step>

  <Step>
    Select "Convert to Toggle"
  </Step>
</Steps>

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.

<Info title="Keyboard Shortcuts">
  * 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)
</Info>

## 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:

<Steps>
  <Step>
    Expand the toggle so you can see its content
  </Step>

  <Step>
    Right-click on the toggle block
  </Step>

  <Step>
    Select "Convert to Regular Block" (or use Ungroup)
  </Step>
</Steps>

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.

<CardGroup cols={2}>
  <Card title="Blocks and Pages" href="/en/write-and-edit/blocks-and-pages">
    Understanding Craft's structure
  </Card>

  <Card title="Document Styling" href="/en/write-and-edit/styling">
    Format and style your content
  </Card>

  <Card title="Collections" href="/en/organize-and-find/collections">
    Database-like features for structured data
  </Card>
</CardGroup>