Workspace Templates and Blueprints

Page Templates

Page templates are defined in config/workspace.php:

'page_templates' => [
    'blank' => [
        'title' => 'Untitled',
        'blocks' => [],
    ],
    'meeting_notes' => [
        'title' => 'Meeting Notes',
        'blocks' => [
            ['type' => 'heading_1', 'content' => ['text' => 'Meeting Notes']],
            ['type' => 'paragraph', 'content' => ['text' => '']],
            // ...
        ],
    ],
],

Each block has:

type – Block type (paragraph, heading_1, to_do, etc.)
content – Block content (e.g. ['text' => ''], ['text' => '', 'checked' => false])

Adding Custom Templates

Edit config/workspace.php
Add a new key under page_templates with title and blocks
Use block types from App\Models\WorkspaceBlock (e.g. TYPE_PARAGRAPH, TYPE_HEADING_1)

Blueprint Integration

Blueprints (marketplace templates) can be used to create workspace pages. When a blueprint includes workspace blocks, the import process creates pages with the template_key set for tracking.

The API GET /workspace/templates returns templates from config. Blueprint-derived templates appear when the blueprint system is configured to register them under workspace.page_templates.

Template Block Types

Supported block types for templates:

paragraph, heading_1, heading_2, heading_3
bulleted_list_item, numbered_list_item, to_do
code, quote, callout
divider, image, table, toggle
bookmark, embed, columns, date
table_of_contents, synced_block
module_projects, module_tasks, module_companies, module_contacts

Updated on: 13/03/2026

Was this article helpful?

Thank you!