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

# Documents, Pages, and Blocks

> Understand the building blocks of Craft and how they create flexible document structures.

Craft uses three core concepts to organize your content: Blocks, Pages, and Documents. Understanding how these work together will help you make the most of Craft's flexible structure.

<iframe src="https://www.youtube-nocookie.com/embed/LBk28cRY-nk" title="Documents, Pages, and Blocks Introduction" className="w-full aspect-video rounded-xl" allowFullScreen />

## Understanding Blocks

Every paragraph in Craft is a **Block**. Each block can contain its own content and serve a dual purpose:

* As a piece of text or content on the current page
* As the title/entry point to a deeper page with its own nested content

This simple structure allows you to create hierarchies naturally as you write.

<img src="https://mintcdn.com/craft-support/4lRkwRvDwE7Wr43k/images/introduction/documents/en/content/blocks-diagram.png?fit=max&auto=format&n=4lRkwRvDwE7Wr43k&q=85&s=13909325bc4d8dd5856412229a7186a4" alt="Diagram showing blocks as building blocks of documents" width="3104" height="1838" data-path="images/introduction/documents/en/content/blocks-diagram.png" />

## Understanding Pages

When a block contains nested content, it becomes a **Page**. Pages can be styled like any regular block, and clicking on them navigates inside to reveal their content.

<Info title="Page Styling">
  The "Page" text style option (along with the Card style) is specifically designed for blocks that contain nested content, making them visually distinct as entry points.
</Info>

## Understanding Documents

**Documents** are top-level files in Craft that work like traditional digital files. You can:

* Star them for quick access
* Move them into folders
* Sort and organize them
* Delete them (they go to Recently Deleted)

## Moving Blocks Between Documents

You can reorganize content by moving blocks between documents and pages.

**Cut and paste:** Use standard cut/paste operations to move blocks.

**Drag and drop (macOS):** Open two Craft windows within the same Space and drag blocks between them.

<img src="https://mintcdn.com/craft-support/4lRkwRvDwE7Wr43k/images/introduction/documents/en/content/moving-blocks.gif?s=68c430bc44eb678592413ad23acdc41a" alt="Dragging blocks between documents in separate windows" width="600" height="452" data-path="images/introduction/documents/en/content/moving-blocks.gif" />

<Info title="Block Links Preserved">
  When moving blocks within the same Space, all block links are preserved and continue to work correctly.
</Info>

## Grouping Blocks into Pages

Transform multiple blocks into a nested page to create structure in your documents.

<Tabs>
  <Tab title="macOS">
    <Steps>
      <Step>
        Select the blocks you want to group (click and drag, or Shift-click).
      </Step>

      <Step>
        Right-click the selection and choose **Group**, or press `⌘ (Command) + G`.
      </Step>

      <Step>
        The blocks are now nested under a new parent block that acts as a page.
      </Step>
    </Steps>

    <img src="https://mintcdn.com/craft-support/4lRkwRvDwE7Wr43k/images/introduction/documents/en/content/grouping-mac.gif?s=1bef1ce9b1dfb7c17bf8480b649b5f2c" alt="Grouping blocks on macOS using right-click menu" width="600" height="513" data-path="images/introduction/documents/en/content/grouping-mac.gif" />
  </Tab>

  <Tab title="iOS">
    <Steps>
      <Step>
        Use the swipe gesture to select multiple blocks.
      </Step>

      <Step>
        Tap the **Group** action that appears.
      </Step>

      <Step>
        The blocks are now grouped under a new parent page.
      </Step>
    </Steps>

    <img src="https://mintcdn.com/craft-support/4lRkwRvDwE7Wr43k/images/introduction/documents/en/content/grouping-ios.gif?s=a44814bcfd736a734d3d4ff89c4e4b7d" alt="Grouping blocks on iOS using swipe gestures" width="600" height="417" data-path="images/introduction/documents/en/content/grouping-ios.gif" />
  </Tab>
</Tabs>

## Important Notes

<Warning title="Pages vs Documents">
  Pages (nested content within documents) are treated as blocks, not separate documents. If deleted, they do **not** go to the Recently Deleted folder. You can:

  * Use **Undo** (`⌘ + Z`) immediately after deletion
  * Restore an earlier version of the parent document using version history
</Warning>

## Getting Started

Craft is designed to be intuitive. **Just start writing** as you normally would. Whenever your document gets too long or you need more structure, you'll naturally discover how pages work by grouping related blocks together.

<CardGroup cols={2}>
  <Card title="Managing Documents" href="/en/introduction/documents/manage">
    Learn how to create, delete, and organize documents
  </Card>

  <Card title="Document Organization" href="/en/organize-and-find">
    Explore folders, tags, and spaces for organizing content
  </Card>
</CardGroup>