Figures

Figures are publication-ready infographics built from OpenData datasets. Create a chart, customize it with annotations and themes, and share it with anyone. Viewers can click through to the underlying dataset to explore the data themselves.

Live figures vs snapshots

Every figure stores data in one of two ways. Understanding the difference helps you choose the right approach for your use case.

 Live FigureSnapshot Figure
Data sourceFetches fresh rows from the linked dataset every time it loadsFrozen rows stored inside the figure itself
FreshnessAlways up to date when the source updatesNever changes (stable forever)
RiskCan break if the dataset schema changes (column renamed or removed)None. Data is self-contained.
Created byBuilding a figure from a dataset in the editorSaving from Claude (MCP), cloning, or freezing a live figure

You can convert a live figure into a snapshot at any time using the “Freeze data” button in the Data panel. This captures the current rows so the figure never changes, even if the underlying dataset is updated later.

Creating figures with Claude

The fastest way to create a figure is through Claude. If you have the OpenData MCP tools connected, Claude can generate charts directly in your conversation.

Here's how the flow works:

  1. Ask Claude a data question (e.g., “Show me US inflation trends since 2020”)
  2. Claude searches datasets, queries the data, and renders an interactive chart
  3. Click Save on the chart to persist it as a draft figure
  4. Open the draft in the figure editor to make adjustments (theme, title, annotations)
  5. Publish when you're happy with it

Draft figures created through Claude show a “From Claude” badge. They're snapshots by default since the data is captured at creation time.

For more details on the charting tools available to Claude, see the Creating Charts with Claude guide.

The editor

The figure editor is available at /figure/new (create) or /figure/:id (edit an existing figure you own). It requires a desktop browser (1024px minimum width).

The editor has two modes:

  • GUI mode - A sidebar with five panels (Data, Chart, Chrome, Annotations, Theme) next to a live preview canvas. Point and click to build your figure.
  • Code mode - A JSON editor next to the live preview. Paste a chart spec from Claude or write one by hand. Changes in the JSON are reflected on the canvas instantly.

Switch between modes at any time. Your work carries over.

Chart types

The Chart panel lets you pick from: bar, line, area, point, arc (pie/donut), and table. Each type has its own encoding options (which columns map to which visual channels like x-axis, y-axis, and color).

Aspect ratios

The toolbar includes an aspect ratio picker with three options: 16:9 (landscape, good for presentations), 1:1 (square, good for social media), and 4:5 (portrait, good for mobile feeds). The canvas resizes to match.

Undo and redo

Every change pushes to a history stack. Undo and redo let you step back through your last 50 edits.

Chrome and annotations

Chrome is the text that surrounds your chart: title, subtitle, data source citation, byline, and footer. Each field supports style overrides (font size, weight, and color) so you can create visual hierarchy.

Annotations are visual callouts layered on top of the chart. Three types are available:

  • Text callouts - A label positioned at specific coordinates, optionally connected to a data point with a line or curve
  • Range highlights - A shaded region (horizontal or vertical) that draws attention to a specific span of the data
  • Reference lines - A horizontal or vertical line at a specific value (e.g., an average, a threshold, or a target)

Annotations are what turn a chart into a story. They're the primary tool for the “last 20%” of editorial polish that makes a figure publication-ready.

Themes

The Theme panel offers six presets: Default, Warm, Cool, Monochrome, Earth, and Bold. Picking a theme changes the color palette, background treatment, and overall visual tone of the figure. You can also customize individual categorical colors within any theme.

Export and share

When your figure is ready, you have two paths:

  • Export - Download as PNG, SVG, or JPG at 1x or 2x resolution. JPG includes a quality slider. You can also copy the SVG or the raw spec to your clipboard.
  • Publish - Save the figure with a name and optional description. Published figures appear in the public figures feed and on your profile page. Anyone with the link can view it.

Published figures include a like button. Popular figures surface higher in the discovery feed.

Browse figures

The figures gallery shows all published figures. Sort by popular (most liked) or recent (newest first). Click any figure to see it full-size along with metadata about how it was made.

The detail page includes a “How it was made” panel that shows the source dataset, columns used, filters applied, and any transforms. It's designed to make figures reproducible and to help viewers discover interesting datasets.

Programmatic access

Figures are accessible through the API for integrations and automation:

  • GET /v1/figures - List public figures (supports sort=popular or sort=recent, plus limit and offset)
  • GET /v1/figures/:id - Get a single figure with its full viz spec and metadata
  • POST /v1/figures/drafts - Create a draft figure from snapshot data (requires authentication)
  • PUT /v1/figures/:id/like - Like a figure (idempotent)
  • DELETE /v1/figures/:id/like - Unlike a figure

See the API Reference for full request and response schemas.

Related

  • Creating Charts with Claude - Detailed guide on using the OpenChart MCP tools
  • Use with AI - Set up Claude with OpenData MCP tools
  • Views - How views transform data at query time (figures can use any view as their data source)
  • Data Export - Export raw data in CSV, JSON, XLSX formats

Search datasets

Search for datasets or run quick actions