Skip to content

Learn Chartosaurus.
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
  • 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, plus heatmap, sankey, treemap and calendar 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

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://chartosaurus.com/embed/YOUR_CHART_ID
A private chart — copy it from the builder's Embed link field; the token is the password
https://chartosaurus.com/embed/YOUR_CHART_ID?token=YOUR_EMBED_TOKEN
Forcing a theme — dark and light on every plan, auto from Starter
https://chartosaurus.com/embed/YOUR_CHART_ID?theme=dark
A shared dashboard — copy it from Share on the dashboard (Starter and up)
https://chartosaurus.com/embed/dashboard/YOUR_DASHBOARD_ID?token=YOUR_SHARE_TOKEN

Need help?

Email us at support@chartosaurus.com.