Connecting your Notion to TRMNL takes just a few seconds.
Step 1 - Visit the Notion Plugin
Inside TRMNL, navigate to Plugins > Notion.
Step 2 - Connect Notion
Click "Connect with Notion" on the right side, and you'll be guided to log into Notion and accept our permissions.
TRMNL only requires "read" access, we will not update any of your Notion data, and you will have the ability to specify the content you want TRMNL to have access to on the next screen.
Step 3 - Configure Plugin
Both types of Notion content, Databases and Pages, are supported through the TRMNL plugin.
Databases
When displaying a Notion "Database", you can configure how your database items appear in your TRMNL.
Database: Select your Notion database (e.g., "Customer Support Tickets", "Product Feedback")
Item Limit: Set how many database items to display (1-100, default: 20)
Title Field: Choose which property shows as the main title (default: "Name")
Status Field: Select a property to display as a prominent badge next to the title
Labeled Properties: Add comma-separated properties to show as styled badges
Listed Properties: Add comma-separated properties to display as text details
Sort By: Choose a property to sort by (or use "created_time"/"last_edited_time")
Sort Direction: Ascending or Descending
Multi-Column Display: Show items in 1 or 2 columns (full/half-horizontal views)
Example for Support Database
Database: Customer Support Tickets
Title Field: Ticket Title
Status Field: Priority Labeled
Properties: Status, Assignee, Customer Tier
Listed Properties: Description, Last Updated, Response Time
Sort By: created_time
Sort Direction: Descending
This would display support tickets with:
Ticket title as the main heading
Priority shown as a large badge (e.g., "High", "Medium", "Low")
Status, Assignee, and Customer Tier as smaller alternating-style badges
Description and other details listed below each ticket
Page Display Type
When displaying a Notion "Page", you show the ordered content blocks available in a page
Page: Select your specific Notion page (e.g., "Integration Guide", "Support Team Handbook")
Item Limit: Maximum content items to fetch (1-100, default: 20)
Image Height: Set maximum height for images in pixels (default: 120)
Multi-Column Display: Choose 1 or 2 column layout
Example for Intercom Documentation Page
Page: Support Team Handbook
Item Limit: 25
Image Height: 200
Multi-Column Display: 1
This would display:
The full content of your Intercom Integration Guide page
Images sized to maximum 200px height
Content in a single column for better readability
Up to 25 content blocks from the page
Notion Block Support Details
We support all Notion block types with the exceptions listed below. The plugin fetches and displays most content blocks including text, headings, lists, images, and more.
Nested Content
No nested children support - Only the top layer of the page is fetched
Toggle block contents - Children inside toggle blocks are not displayed
Unsupported Types
table_of_contents
table (including all table child blocks)
unsupported types by the Notion API
synced_block
breadcrumb
column_list
Links
Some links may not display properly, particularly links to other Notion pages (dependent on Notion API responses)
Numbered Lists
Numbers are not displayed in numbered lists due to API limitations. Numbered lists will appear as bullet points instead
People Mentions
All people mentions display as "@anonymous" due to API privacy restriction
Emojis
Emojis are stripped from text due to TRMNL platform limitations
This affects Notion's typically emoji-rich content
Best Practices
Use simple, flat page structures for best results
Avoid use of tables and toggle blocks for content you need displayed
Consider using databases instead of complex page layouts when possible
Step 4 - You're Done!
Based on your device's refresh settings, you'll begin seeing Notion content very soon. Stay focused.