How to Add a Pomodoro Timer to Notion
Embed a live Pomodoro timer directly into your Notion workspace using CleanStopwatch. Step-by-step with screenshots and tips.
Why Add a Pomodoro Timer to Notion?
Notion is great for keeping tasks, notes, and projects organized, but it doesn’t have a built-in timer. Every time you want to start a focus session, you’re bouncing between your workspace and a separate timer app. That switching costs you focus.
Embedding CleanStopwatch directly into your Notion page fixes that. Your Pomodoro timer sits right next to your task list, notes, or project dashboard. No alt-tabbing, no app hopping.
Think about the scenarios where this really matters. You’re a student with a research paper due — you’ve got your outline in Notion, your sources in a database, and now the timer right there keeping you on track for 25-minute writing sprints. Or you’re a freelancer tracking billable hours — the stopwatch mode lives beside your project notes, so you can log time without opening a separate tool. The timer becomes part of your workspace, not another tab begging for your attention.
There’s also the subtle psychological effect. When your timer lives inside the same page as your to-do list, it creates a natural association: this page is where work happens. Opening it puts you in the right mindset. Compare that to keeping your tasks in Notion and your timer in a separate app — you’ve got two contexts to manage, and each switch chips away at your momentum.
What You Need to Embed a Timer in Notion
- A CleanStopwatch timer or a customized widget
- A Notion page (any plan: Free, Plus, Business, or Enterprise)
- About 60 seconds
That’s it. No browser extensions, no third-party services, no code to write.
Step-by-Step Notion Timer Setup
Step 1: Configure Your Timer
Open the CleanStopwatch Configurator. Pick your settings:
- Timer mode: Pomodoro
- Work interval: 25 minutes (or whatever works for you)
- Break interval: 5 minutes
- Colors: Match your Notion theme (dark or light mode)
- Border radius: Square or rounded, whatever fits your page layout
The preview updates in real-time as you tweak things. Play around with the settings until it looks like it belongs on your page.
One thing that trips people up: the font size slider. If you’re embedding the timer in a narrow Notion column, bump the font size down so the widget doesn’t overflow. If it’s going on a wide dashboard, crank it up so you can read it without squinting.
Step 2: Copy the Embed URL
Once you like how it looks, copy the Live Embed URL at the bottom of the Configurator. This URL packs all your settings as query parameters — colors, mode, interval lengths, everything.
It’ll look something like: https://cleanstopwatch.com/embed?mode=pomodoro&work=25&break=5&color=blue
You can bookmark this URL too. If you want the same timer setup on multiple Notion pages, just paste the same URL into each one. No need to go through the Configurator again.
Step 3: Embed in Notion
- Open your Notion page.
- Type
/embedand hit Enter. - Paste the CleanStopwatch URL into the embed link field.
- Click Embed link.
The timer shows up as a live, interactive widget on your page. It works right away — start, pause, reset, all from inside Notion.
If /embed doesn’t show up as an option, make sure you’re typing it on an empty line. Notion can be picky about that. Also use the straight /embed command, not /embeds with an s — that’s for something else entirely.
Step 4: Resize and Position
Grab the bottom-right corner of the embed block to resize it. Notion handles the aspect ratio automatically. Place the timer above your task list or next to your weekly planner.
A common setup that works well: put the timer at the top of your page in a wide column, then stack your tasks underneath. That way the time is always visible while you’re scrolling through your work. The timer acts as a visual anchor — you glance up, see your progress, and keep going.
Keyboard Shortcuts in Your Notion Timer
The embedded timer supports the same keyboard shortcuts as the main site:
- Space — Start or pause the timer
- R — Reset the timer back to zero
- F — Toggle fullscreen mode (useful if you want the timer to take over your screen during a deep focus block)
- L — Record a lap (only in stopwatch mode)
These shortcuts work even when the timer is embedded in Notion. Just click the widget once to give it focus, then tap the key.
This is one of those small things that makes a big difference in practice. Instead of reaching for your mouse to hit a tiny button, you just press Space and the timer starts. Over the course of a day, those small frictions add up. When you’re in a flow state, even the half-second it takes to find and click a button can pull you out. Keyboard shortcuts keep you in the zone.
Using Stopwatch Mode with Lap Tracking
Pomodoro isn’t the only mode worth embedding. The stopwatch with lap tracking is great for things like:
- Tracking how long different tasks take. Start the stopwatch at the beginning of a study session, hit L each time you switch subjects, and review the lap times later to see where your time actually went. This is eye-opening the first time you do it — most people have no idea how they actually spend their study time.
- Timed presentations or speaking practice. Hit L between sections to see how long each part runs. Useful for anyone prepping a talk or presentation in Notion.
- Workout or break timing. Track your rest intervals without resetting the whole timer.
The lap data is displayed right on the timer, so everything stays inside Notion. You don’t need to write down lap times anywhere else.
Tips for Your Notion Workspace
Add it to a dashboard. Create a dedicated “Focus” section at the top of your dashboard page. Drop the timer there alongside your priority tasks for the day. This works especially well if you use a weekly dashboard template — the timer becomes a permanent fixture that reminds you to start working every time you open the page.
Use it with a database template. If you track study sessions in a Notion database, add the timer embed to the template. Every new entry automatically comes with a timer. For example, create a “Study Session” database with properties for subject, duration, and notes. Add the timer embed to the template page, and every time you log a new session, the timer is already there waiting.
Combine with a daily log. Embed the timer next to a daily journal block. Start the timer, work, jot down notes, repeat — all on one page. This is one of those setups that sounds simple but works incredibly well in practice. You get a natural rhythm going: glance at the timer, write a few thoughts about what you’re working on, glance back. It turns note-taking into a side effect of focused work instead of a separate task.
Dark mode. If you use Notion in dark mode, set the timer theme to dark in the Configurator before grabbing the embed URL. The widget blends right in. Same goes for light mode — the light theme is clean and minimal, so it never clashes with Notion’s default look.
Multiple timers on one page. You can embed more than one timer on the same Notion page. Try a Pomodoro timer for focused work and a countdown timer for meeting slots side by side. Embed each one separately with different settings from the Configurator. This is a game-changer for anyone who runs meetings in Notion — you can have a Pomodoro for your personal focus and a countdown to keep the meeting on schedule, both visible at the same time.
Troubleshooting Your Notion Pomodoro Timer
Pomodoro timer doesn’t load. Make sure the URL is a clean https://cleanstopwatch.com/embed?... link. Don’t wrap it in an iframe tag. Notion’s /embed command handles that for you. If it still doesn’t load, double-check that your internet connection is working — CleanStopwatch requires an internet connection to run.
Timer resets when switching pages. Notion’s embed reloads fresh every time the page is viewed, so session state isn’t preserved. That’s expected. Just start the timer when you begin your session. It takes one second.
Can’t see the full widget. Adjust the embed block dimensions. If you set the width really wide in the Configurator, try a taller aspect ratio in Notion. You can also go back to the Configurator and pick a smaller size.
Is the embedded timer interactive? Yes. You can start, pause, and reset the timer right within Notion. The widget is fully functional — keyboard shortcuts included.
Sound doesn’t play when the timer finishes. Notion embeds sometimes have trouble with audio playback in certain browsers. If the alert sound doesn’t play, check that your browser allows audio from embedded content. Chrome and Firefox both work reliably with CleanStopwatch embeds.
The timer looks too small on mobile. Notion’s mobile app handles embeds differently than the desktop version. If you’re planning to use the timer on your phone, test it in Notion’s mobile browser to make sure the sizing works for you. You might need a larger font size in the Configurator.
Can I use the stopwatch with lap tracking in Notion? Absolutely. Just configure the timer in stopwatch mode before copying the embed URL. The lap button works inside Notion, and you can track as many laps as you need. Just click the widget, hit L, and your lap is recorded.
Can I use it on someone else’s shared page? If someone shares a Notion page with you that has an embedded timer, you can interact with it just like any other embed. You don’t need your own CleanStopwatch account or anything.
CleanStopwatch Pro Features for Notion Users
The free version of CleanStopwatch gives you 5 themes, 2 sounds (Default Chime and Classic Beep), and up to 120 minutes max duration. That covers most Notion setups.
If you want more, Pro adds:
- Full hex color picker — match your accent color exactly to your Notion theme or brand colors
- 13 themes instead of 5
- 16 sounds instead of 2
- Ad-free experience — no interruptions during your focus sessions
No signup required for the free tier, and no account needed either. Pro is there if you want to take things further with custom styling and more options.
Why CleanStopwatch Beats Other Notion Timers
| Feature | CleanStopwatch | Other Timers |
|---|---|---|
| Signup required | No | Often yes |
| Free tier has ads | Occasional | Pop-ups, banners |
| Ad-free option | Pro upgrade | Often not available |
| Custom accent colors | Full hex picker (Pro) | Limited presets |
| Works in Notion /embed | Yes | Sometimes broken |
| Timer modes | Pomodoro + Stopwatch + Countdown | Usually just one |
| Keyboard shortcuts | Space, R, F, L | Rarely supported |
Quick Links
- CleanStopwatch Timer — start immediately, no config needed
- Configurator — customize colors, modes, intervals
- Notion Timer Widget Guide — more embed tips