Skip to content

Learn ChartOmodo.
Fast.

Quickstart, data sources, charts, and embedding in Notion.

Quickstart

  • Connect a Notion database from the Connect screen
  • Pick an X axis, a Y axis and an aggregation in the builder
  • Copy the /embed link and paste it into a Notion page

Data sources

  • Notion — connect via OAuth; the token is encrypted at rest
  • Refresh on demand from the chart list, or automatically via the Notion webhook
  • Rollups: a calculated rollup (sum, average, min, max) reads as the number Notion computed; a “Show original” rollup over numbers reads as their total
  • Numbers stored as text: a cell counts only when all of it is a number, with a short currency or unit at most (“Rp 1.500”, “12 kg”); one column is read under one decimal convention
  • CSV — upload a file at /connect/csv; up to 5 MB and 50,000 rows, stored in full until you delete the connection

Charts

  • Types: bar, line, area, pie, donut, KPI, Radar (Pro), plus heatmap, sankey, treemap, calendar, stream, bump, sunburst and waterfall on Pro
  • Aggregation: count, sum, average, min, max
  • Filters, date grouping (week/month free, day/quarter/year Pro) and multi-series (per-tier cap)
  • Annotations: vertical reference lines (Pro)

Embed

  • Paste the embed URL into Notion with the /embed command
  • Embeds are currently limited to Notion pages — other sites are blocked from framing them
  • ?theme=dark|light|auto overrides the saved theme; dark and light on every plan, auto from Starter
  • A private chart's link is its credential: anyone holding the URL with ?token= can view the chart. Treat it like a password
  • Leaked? Save the chart in the builder and choose Rotate link in the dialog — every copy of the old link stops working
  • Embed pages send no Referer header, so the token is not passed on to anything the page loads or links to
  • Custom CSS restyles the embed on Business

Guides

Illustrated guides for the things users ask us about most.

Embed a chart in Notion

  1. Open the chart in the builder and copy its Embed link — a private chart’s link already carries its token.
  2. In Notion, type /embed and paste the link. The block renders the live chart, not a screenshot.
  3. To resize, hover the block and drag the handle on its right or bottom edge — the chart re-renders to fill the new box.
  4. To make it wider than the text column, drag the block to full width from the block menu (⋮⋮ → Full width).

Light & dark themes

Every plan can pin a theme: use https://chartomodo.com/embed/YOUR_CHART_ID?theme=dark or https://chartomodo.com/embed/YOUR_CHART_ID?theme=light. https://chartomodo.com/embed/YOUR_CHART_ID?theme=auto follows the reader’s Notion appearance and starts on Starter. Without a parameter the chart keeps the theme saved in the builder.

Private links (token + password)

A private chart’s embed URL is its credential: the token= part of a link like https://chartomodo.com/embed/YOUR_CHART_ID?token=YOUR_EMBED_TOKEN is the password, so anyone holding the link can view the chart. Share it like a password, not like a URL. If a link leaks, open the chart in the builder, save it and choose Rotate link — every copy of the old link stops working at once. Password-protected shares ask for the password before the chart draws.

Notion mobile: what works

On the Notion mobile app an embed renders as a block you tap to open; charts are responsive, so expect a narrower layout with fewer axis labels rather than a cut-off chart. Editing still belongs to the desktop browser — sizing and theme changes are easiest there.

Per-row math: use a Notion formula

ChartOmodo does not compute per-row fields — your Notion formula does, and we chart the result. Add a formula property to the database (for example prop("Qty") * prop("Price")), then pick that property as the Y axis. Notion’s formula documentation covers the syntax.

Troubleshooting

  • The embed shows nothing, or Notion says the link can’t be embedded. The URL must be a chartomodo embed link (a path under /embed/) — a /charts link is the editor’s own page and will not render.
  • The chart is empty or “no data”. Refresh the connection from the chart list; a Notion database added after the last refresh only appears once it has run.
  • A number column reads as zero or is missing. We read a cell only when all of it is a number, with a short currency or unit at most (“Rp 1.500”, “12 kg”).
  • Colours look wrong on a dark page. Pin the theme by appending theme=dark to the embed URL; theme=auto is Starter and up.
  • A rotated link still opens the chart. The old link can survive in a browser cache for a moment; reload the page, then contact support if it persists.

Embed URLs

What the links look like. Replace the capitalised parts — the app shows every chart’s real link, token included, so there is nothing to assemble by hand.

A public chart — the link shown on /charts
https://chartomodo.com/embed/YOUR_CHART_ID
A private chart — copy it from the builder's Embed link field; the token is the password
https://chartomodo.com/embed/YOUR_CHART_ID?token=YOUR_EMBED_TOKEN
Forcing a theme — dark and light on every plan, auto from Starter
https://chartomodo.com/embed/YOUR_CHART_ID?theme=dark
A shared dashboard — copy it from Share on the dashboard (Starter and up)
https://chartomodo.com/embed/dashboard/YOUR_DASHBOARD_ID?token=YOUR_SHARE_TOKEN

Need help?

Email us at support@chartomodo.com.