Add a Notion widget.
Make it yours.
Start with one useful widget, customize it at the source, and embed the resulting URL in your Notion page.
The short version
Open the widget's own detail page, adjust its available settings, copy the intended HTTPS embed URL, then create an Embed block in Notion using /embed or the block menu. Paste the URL and resize the block to fit. The widget remains hosted by its source; embedding it does not install a native Notion feature or create a Notion database connection.
1. Choose one widget for a real task
Start with a specific need: a timer for focused work, a calendar for dates, or a small reference display. Browse the Saif Saber Studio widget catalog, open the matching detail page and check what it actually does. Do not add a dozen widgets before confirming one is readable and useful on your device.
Check the source's stated requirements. A public clock is different from a widget that asks for account access or an external API key. Do not paste private tokens or unrestricted keys into a shareable embed URL.
2. Customize settings before copying the link
Widget detail-page controls and controls inside the running widget are different. For example, the current Pomodoro Timer detail page lists light/dark theme, five sizes, transparent background, work and break lengths, cycle count, auto-start and sound options. The timer itself has Play/Pause, Reset and Skip controls. Changing an embed's size in Notion does not automatically change the timer's configured duration.
- Choose the available theme and dimensions for the page where it will appear.
- Change only settings you understand, such as work and break length for a timer.
- Use the source page's supported copy/share URL control; do not assume every URL parameter works for every widget.
- Open the copied URL in a new browser tab and check the resulting appearance before embedding it.
The Pomodoro source currently lists a default 25-minute work period, 5-minute short break and a 15-minute long break after four cycles. These are product-source defaults, not a recommended schedule for every reader.
3. Add the URL to a Notion Embed block
- Open the Notion page you can edit and place the cursor where the widget should appear.
- Type
/embedor use the add-block menu to choose Embed. - Paste the widget's intended HTTPS URL, then confirm the embed.
- Use the block's resize handles to give controls enough room. Check the same page on a narrow screen.
- Keep a regular text link to the source page as a fallback for people whose embed cannot load.
Notion's official Embed documentation explains the block and resizing handles. Not every external site permits framing; Notion also warns that embeds requiring an outside login will not work in its desktop or mobile apps. A working browser preview alone does not establish native-app support.
Example: set up a focus timer
Try a single focus session. Choose a work length on the Pomodoro settings page, copy the intended widget link, embed it in a study page and leave space for a short task list beside or below it. Start the timer from its own controls. After the session, write one sentence about the task you finished.
This preview is an enhancement, not a substitute for the instructions. Its real keyboard focus, dimensions, storage and Notion-app behavior must still be tested in browser and native environments before approval.
What an embed does not guarantee
A Notion Embed block displays an external source. It does not promise offline operation, Notion database sync, cross-device settings or persistence across browser profiles. Pomodoro Timer records only naturally completed focus phases in browser-local storage. Skipping advances the timer without adding a completed session or focus minutes; Focus Scoreboard can read the log only when the widgets share a storage context. Logged phases do not prove time worked, and a website and Notion embed may use separate storage. Clearing site data may erase shared focus history; export a backup first.
If the frame is blank, first open the URL directly. If it works only outside Notion, compare host embedding policy, external login, network and browser context. If the widget appears but is clipped, resize it. For detailed diagnosis, see the widget troubleshooting checklist. Do not bypass source-site security restrictions.
Common questions
Can I change a widget after embedding it?
Usually you can edit the block URL or return to the widget's source settings. The exact method depends on how that widget encodes its options; do not assume settings are synchronized automatically.
Will my widget work on Notion mobile?
Not always. Check the specific source and native app. External login, frame policy and small-screen layout can behave differently from a desktop browser.