Skip to main content

Notion

Display pages and databases.

Ryan Kulp avatar
Written by Ryan Kulp
Updated yesterday

Connecting your Notion to TRMNL takes just a few seconds.

Step 1 - Visit the Notion Plugin

Inside TRMNL, navigate to Plugins > Notion.

Notion-TRMNL-dashboard-example

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-Notion-Oath2-Content-Permissions-Selection

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.

Did this answer your question?