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

# Indent Depth Limits

> Understanding the 5-level indentation limit designed for mobile readability and document structure.

Craft limits block indentation to **5 levels deep** across all platforms. This constraint ensures your documents remain readable and well-structured, especially on mobile devices where screen space is limited.

## The 5-Level Limit

You can indent blocks up to 5 levels:

1. **Level 1** – Root level (no indentation)
2. **Level 2** – First indent
3. **Level 3** – Second indent
4. **Level 4** – Third indent
5. **Level 5** – Maximum depth (deepest indent)

When you reach level 5, the indent button becomes disabled and you cannot indent further.

<img src="https://mintcdn.com/craft-support/crCjmeXe7Wo0HfP_/images/write-and-edit/blocks-and-pages/indent-limits/en/content/indent-limit.png?fit=max&auto=format&n=crCjmeXe7Wo0HfP_&q=85&s=b3d2bf6e8e60880dc1df6d1afa8f668e" alt="Maximum indentation depth of 5 levels" width="265" height="205" data-path="images/write-and-edit/blocks-and-pages/indent-limits/en/content/indent-limit.png" />

<Info title="Design Decision">
  The 5-level limit is intentional, not a technical limitation. It encourages clearer document structure and ensures content remains accessible on all devices.
</Info>

## Why This Limit Exists

**Mobile readability**: On iPhone and iPad screens, deeply nested content becomes difficult to read and navigate. Five levels provide sufficient hierarchy while maintaining usability.

**Document clarity**: Extremely deep nesting often indicates overly complex structure. The limit encourages you to break content into separate pages or reorganize for better clarity.

**Consistent experience**: The same limit applies across Mac, iOS, Windows, and Web, ensuring your documents look and work the same everywhere.

## Working Within the Limit

If you find yourself hitting the 5-level limit, consider these alternatives:

### Use Subpages

Instead of deep nesting, create subpages to organize related content.

```
Project Overview
├─ Phase 1 (subpage)
│  ├─ Task 1
│  ├─ Task 2
│  └─ Task 3
├─ Phase 2 (subpage)
│  ├─ Task 4
│  └─ Task 5
```

This keeps your structure shallow while maintaining organization and allowing each phase to have its own focused document.

### Reorganize Content

Deep nesting might signal that content should be split:

**Instead of this**:

```
Main Document
├─ Category A
│  ├─ Subcategory 1
│  │  ├─ Item 1
│  │  │  ├─ Detail 1
│  │  │  │  └─ Sub-detail (can't indent further!)
```

**Try this**:

```
Main Document
├─ Category A (link to separate page)

Category A Page
├─ Subcategory 1
│  ├─ Item 1
│  │  └─ Detail 1
```

### Use Collections

For structured data with many attributes, Collections provide a better solution than deep indentation:

Instead of nesting client information 5+ levels deep, use a Collection with fields for each attribute. Each row can have its own subpage with unlimited organization.

### Combine with Toggles

Use toggle blocks to hide complexity without adding indentation depth:

```
Project Tasks
├─ High Priority
│  └─ [Toggle] 10 tasks hidden
├─ Medium Priority
│  └─ [Toggle] 15 tasks hidden
```

This keeps your document structure clean while allowing detailed content when needed.

## Platform Differences

The 5-level limit applies consistently across all platforms, but the way you interact with it varies:

**macOS**: Indent with `Tab`, outdent with `Shift+Tab`. The Tab key becomes inactive at level 5.

**iOS/iPadOS**: Use the indent buttons in the toolbar or swipe gestures. The indent button is disabled at level 5.

**Windows/Web**: Use `Tab` and `Shift+Tab` similar to macOS.

<Warning title="Lists and Outlines">
  This limit applies to **all block types** including text blocks, tasks, lists, and pages. There are no exceptions.
</Warning>

## Common Questions

**Can I request deeper nesting?**

The 5-level limit is a design decision that balances structure with readability. If you need deeper hierarchy, consider using subpages or Collections instead.

**Does this affect Collections?**

Collections themselves don't have indentation limits, but content within collection cells follows the same 5-level rule.

**What about imported documents?**

When importing documents with deeper nesting (like from other apps), Craft flattens content beyond level 5 to maintain the limit.

<Info title="Best Practice">
  If you regularly hit the 5-level limit, it's a signal to reconsider your document structure. Clear, focused documents with linked subpages are usually easier to navigate and maintain than deeply nested outlines.
</Info>

## Related Articles

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

  <Card title="Creating Subpages" href="/en/introduction/documents">
    Organize content with nested documents
  </Card>

  <Card title="Collections" href="/en/organize-and-find/collections">
    Structure complex data with database-style tables
  </Card>
</CardGroup>