Connecting Notion
Connect a Notion workspace, choose a database, and sync it into Lumio.
Connecting Notion
Lumio reads from Notion databases you connect to your organization. One Source mirrors one Notion database. Widgets reuse Sources through bindings.
1. Connect a Notion workspace
In Lumio, open Notion connections and click Connect Notion.
Notion will ask which workspace and pages/databases Lumio can access. Pick the workspace and include the database you want to sync.
You do not paste an internal integration token into Lumio. Lumio stores the OAuth token encrypted.
2. Create a Source
Open Sources -> New source.
Choose:
| Field | What it means |
|---|---|
| Workspace | The connected Notion workspace. |
| Database | The Notion database/data source to mirror. |
| Display date | The date property Lumio should use for ordering and display. |
If Display date is set to Auto, Lumio uses:
Date property -> any date-type property -> Notion created time
Lumio never uses Notion last_edited_time as the display date.
3. Sync the Source
Click Sync on the Source.
Lumio stores page metadata, properties, display dates, excerpts, icons, covers, and content record maps. Synced pages are stored once at the Source level, then reused by widgets.
Notion webhooks can trigger follow-up syncs when Notion changes. You can still sync manually from the dashboard.
4. Bind the Source to a Widget
Open a Widget and bind the Source with a role:
| Role | Surface |
|---|---|
updates | Product updates |
docs | Docs/help center |
Bindings can also add a label, sort order, and property filters. This means the Source can mirror the full database while each widget exposes only the pages it needs.
Property Mapping
Lumio reads these Notion properties:
| Property | Type | Required | Notes |
|---|---|---|---|
| Title column | Title | Yes | Matched by Notion type, not by property name. |
| Display date property | Date | No | Chosen on the Source. Auto fallback is Date, any date property, then created time. |
Description | Text | No | Shown as the update/article excerpt. |
Slug | Text | No | Custom article slug. |
| Other properties | Status, select, multi-select, checkbox, etc. | No | Stored for binding filters and future display/reporting. |
Description and Slug are matched by name. The title column can have any name.
Publishing Model
Lumio does not rely on a source-level published filter anymore.
Current model:
Source mirrors database -> Widget binding filters public subset -> Widget renders matching pages
This avoids re-syncing the same database for every widget and lets one Source power multiple widgets.