Embed sunora widgets in Notion (and other tools)

You do not have to live inside Sunora to use it. Every widget has a standalone URL, which means you can drop a live, interactive copy into any surface that accepts an iframe - Notion pages, Ghost posts, an internal wiki, even a Linear doc. The embed stays in sync with your account, so a habit you tick off in Notion shows up in your planner the next time you open it.

Why embed?

• Keep the context where the work happens - track reading inside the doc you write notes in.
• Share a single dashboard with a coach, partner or team without giving them planner access.
• Reuse the same widget on multiple surfaces - once on your planner, once on a Notion page, once on your blog.

Embed in three steps

1. 1

   Pick the widget you want to share

   Open the widget on its standalone page - either from the marketplace or from inside a planner via the "Open standalone" action. The standalone view is exactly what your embed will render.

2. 2

   Copy the embed link

   Click "Share → Embed" in the widget header. sunora generates a signed URL with a short-lived token, then writes it to your clipboard. Do not edit the URL by hand - the token authorises the widget to read and write your data.

3. 3

   Paste into Notion

   In Notion, type "/embed" on a new line, paste the URL and confirm. Notion renders the widget inline and resizes with the column. The same paste works in Ghost, BookStack, GitBook and most modern doc tools - anything with an embed block.

What is in the embed URL

The embed URL has a predictable shape: /embed/{widget-code}?t={token}&theme={theme}&language={language}. The token is a short-lived JWT that scopes the embed to your widget instance. Theme and language are optional overrides - leave them off and the embed follows the host page (Notion light/dark, browser language).

Three good widgets to embed

Some widgets shine in Notion specifically because the host page already provides the surrounding context. Here are three crowd-favourites - copy the URL pattern under each one as a starting template.

Theme and language sync

By default the embed picks up the host page's colour scheme and the browser language, so a Notion user on dark mode in Turkish sees a dark, Turkish widget without you doing anything. If you want to lock a specific look - say, a light-mode embed inside an otherwise dark Notion page - append theme=light or language=en-US to the URL. Both parameters are optional and override the auto-detected value.

Limits to know about

• Embed tokens are scoped to a single widget instance. They cannot enumerate other widgets or planners.
• Tokens have a generous lifetime, but if Notion ever shows an "Expired" message just regenerate the embed and re-paste the URL.
• Some intranet tools strip iframes by default - ask your admin to allow Sunora as an embed source if the widget shows up blank.

FAQ