Blocks and Pages

Learn how Craft’s block-based structure lets you build documents that grow with your ideas.

Craft uses a unique block-based structure that makes organizing your work intuitive and flexible. Understanding how blocks, pages, and documents work together is fundamental to getting the most out of Craft.

What is a Block?

In Craft, everything you create is a block. Every paragraph, image, table, or heading is its own independent unit. This might seem simple, but it’s incredibly powerful.

Each block can:

• Contain its own content (text, media, tables, etc.)
• Be styled independently
• Be moved, copied, or deleted on its own
• Transform into a page with deeper content

Think of blocks as LEGO pieces. You can arrange them however you want, and each one can serve multiple purposes.

From Blocks to Pages

Here’s where Craft gets interesting: any block can become a page. When a block contains nested content beneath it, it’s called a page. You can click on a page block to navigate inside it and see all its nested content.

This creates a natural hierarchy:

• A block is a single unit of content
• A page is a block that contains other blocks inside it
• A document is the top-level container you see in your sidebar

You don’t need to plan your structure upfront. Start writing, and when a section gets long or needs more detail, turn it into a page. Craft adapts to your thinking process.

Creating Structure with Page Styles

While any block with nested content is technically a page, Craft offers special visual styles to make pages stand out:

Page Style: This text style is designed specifically for page blocks. It gives the block a distinct appearance that signals “there’s more inside.”

Card Style: Cards provide an even more visual way to represent pages. They can include:

• Cover images
• Custom colors
• Rich previews

Both styles make it easy to scan your document and understand its structure at a glance.

Grouping Blocks into Pages

When you have several related blocks, you can group them into a page. This is perfect for organizing your thoughts as you write.

macOS

To group blocks on Mac:

1. Select the blocks you want to group (click and drag, or Cmd+click multiple blocks)

2. Right-click on the selection

3. Choose “Group” from the menu, or press Cmd+G

The first block in your selection becomes the page title, and all other blocks move inside it.

iOS

To group blocks on iOS:

1. Swipe right on blocks to select them (or use long-press for multi-select)

2. Tap the action menu

3. Choose “Group”

Ungrouping: To reverse the process, select a page block and press Cmd+Shift+G (Mac) or use the “Ungroup” action. All nested blocks move back to the same level as the page.

Moving Blocks Between Documents

Because blocks are independent units, you can easily move them around – even between different documents.

macOS

Method 1: Cut and Paste

1. Select the blocks you want to move
2. Press Cmd+X to cut
3. Navigate to the destination document
4. Press Cmd+V to paste

Method 2: Drag and Drop

1. Open two Craft windows side by side (Cmd+Shift+N for a new window)

2. Click and drag blocks from one window to the other

3. Release to drop them in the new location

   

You can also drag blocks directly onto document names in the sidebar to move them quickly.

iOS

Method 1: Cut and Paste

1. Swipe to select blocks
2. Tap “Cut” in the action menu
3. Navigate to the destination document
4. Tap where you want to paste and choose “Paste”

Method 2: Move to Document

1. Select the blocks
2. Tap the three-dot menu
3. Choose “Move to Document”
4. Select the destination

Web

Cut and Paste Method

1. Select blocks (click and drag, or Ctrl+click on Windows)
2. Press Ctrl+X (Windows) or Cmd+X (Mac) to cut
3. Navigate to destination
4. Press Ctrl+V or Cmd+V to paste

Important Note About Pages vs Documents

Understanding the difference between pages and documents is crucial for organizing your work:

Documents are top-level items that appear in your sidebar. They can be:

• Starred for quick access
• Organized into folders
• Moved to trash and recovered
• Shared or published independently

Pages are blocks within documents. They:

• Only exist inside a parent document
• Don’t appear separately in your sidebar
• Are treated as content within the document
• Can’t be starred or organized independently

When you delete a page (a block with nested content), it doesn’t go to the Recently Deleted folder like documents do. To recover a deleted page, you need to:

• Use Cmd+Z (undo) immediately after deletion, or
• Restore an earlier version of the document using version history

Learn more about version history and data recovery.

Building Your Knowledge, One Block at a Time

The beauty of Craft’s block system is that it matches how you think. You don’t need to decide upfront whether something should be a separate document or a page within a document.

Start writing. If a section needs more detail, turn it into a page. If a page grows too complex, you can always move those blocks into a new document.

This flexibility means your structure can evolve naturally as your ideas develop. Just focus on capturing your thoughts – Craft makes it easy to organize them later.

Common Workflows

Building a Project Plan

1. Create a document called “Q1 Projects”
2. Write each project name as a block
3. Click into each project block to add details inside
4. Add tasks, notes, and files within each project page

Taking Meeting Notes

1. Start with agenda items as regular blocks
2. As discussion happens, add details beneath each item
3. The agenda items automatically become pages
4. Navigate in and out to see overview or details

Creating a Knowledge Base

1. Start with broad topics as blocks
2. Click into each topic to add subtopics
3. Each subtopic can become its own page
4. Build a hierarchy as deep as you need

Toggles

Styling Your Content

Using Collections

Document Organization

Links and Backlinks

AI Assistant