Docs Mode

The Docs surface adds a browsable help center inside your widget. Users can search and navigate articles without leaving your app.

Structure

Docs are organised in a three-level hierarchy, hand-authored in the Lumio dashboard:

Collection
└── Category
    └── Article (a synced Notion page)

• Collection — the top-level grouping (e.g. Getting Started, Billing).
• Category — a section within a collection (e.g. Account, Payments).
• Article — a single help page. Each article is backed by one Notion page from a source bound to the docs role.

Setting up Docs

1. Bind a Source with the docs role — in the dashboard, bind a Notion source to your widget and set the role to docs. See Connecting Notion.
2. Sync — pull Notion pages into Lumio.
3. Build the tree — in the dashboard, go to Docs and create Collections and Categories. Add Articles by selecting synced Notion pages.
4. Publish — the structure is live immediately after saving.

Editing content

Edit the Notion page, then re-sync in the Lumio dashboard. The updated article appears in the widget after sync.

Opening Docs from JavaScript

// Open the Docs surface
LumioWidget('navigate', '/docs')

// Open a specific article by its Notion page id
LumioWidget('article', 'NOTION_PAGE_ID')

// Open Docs with a pre-filled search query
LumioWidget('search', 'billing')

// Show contextual doc suggestions (up to 10 page ids)
LumioWidget('suggest', ['PAGE_ID_1', 'PAGE_ID_2'])

Use suggest to surface relevant articles based on what the user is doing — for example, show billing articles on the billing settings page.