Every Tomatoro Widget URL Parameter, Explained

The Tomatoro widget has no settings panel and no configuration file. Everything it needs comes from the URL you embed. That makes it portable — the same link behaves identically in Notion, a website, a wiki, or a note app. Here's the full reference.

The base URL

https://tomatoro.com/widget

On its own, this loads the timer and follows the viewer's operating system preference for light or dark mode. For many embeds, that's all you need.

Theme control

Add a theme query parameter to lock the appearance regardless of the viewer's OS:

URL	Result
/widget	Follows OS preference
/widget?theme=light	Always light
/widget?theme=dark	Always dark
/widget?theme=system	Explicit system follow

Use a fixed theme when your surrounding page has a fixed look — a light Notion workspace, a dark Obsidian vault, a branded marketing site. Use system (or no parameter) when the widget sits somewhere that itself adapts to the OS.

Combining with size

Sizing isn't a URL parameter — it's set by the container you embed into (the width/height of an iframe, or the block width in a no-code tool). The two work together:

<iframe
  src="https://tomatoro.com/widget?theme=light"
  width="460"
  height="620"
  style="border: 0; border-radius: 24px;"
  title="Tomatoro Pomodoro timer"
></iframe>

• 460 × 620 px shows the full card — segment picker, countdown ring, today's harvest, and controls.
• Drop the height to about 560 px to show just the countdown and controls.
• Keep the width above 320 px so the buttons stay comfortable to tap.

A note on unknown parameters

Anything the widget doesn't recognize is simply ignored, so it's safe to leave tracking parameters or anchors on the URL — they won't break the embed. When in doubt, start from the base URL and add only theme.