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.

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.

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.

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.

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.

When moving blocks within the same Space, all block links are preserved and continue to work correctly.

Grouping Blocks into Pages

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

macOS

1. Select the blocks you want to group (click and drag, or Shift-click).

2. Right-click the selection and choose Group, or press ⌘ (Command) + G.

3. The blocks are now nested under a new parent block that acts as a page.

iOS

1. Use the swipe gesture to select multiple blocks.

2. Tap the Group action that appears.

3. The blocks are now grouped under a new parent page.

Important Notes

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

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.

Managing Documents

Document Organization