> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.app/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>

### 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 Navigation">
  On macOS, you can also use keyboard shortcuts:

  * Press `Cmd+Enter` on a toggle to expand/collapse it
  * Navigate between toggles with arrow keys
</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.

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

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

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