---
title: "New Component - Scatter Plots"
description: "Plot points on X and Y axes from a list of pairs. Size bubbles by a third value, color by category with a legend, and add a trend line."
url: "https://www.imejis.io/changelogs/scatter-component"
image: "https://www.imejis.io/og/components/scatter.jpg"
published: "2026-08-03"
author: "imejis"
---

# New Component - Scatter Plots

## New Component: Scatter

Some questions only a scatter answers: do these two numbers move together, where are the clusters, which point is the outlier. The Scatter component draws it from a flat list of pairs, no charting library in the loop.

### The data

One object per point: `{ x, y }`, with an optional `r`, `label`, `color`, and `category`. The `x` and `y` place the dot on the two axes, and the axes rescale to fit whatever range you send. Add a `category` and points in the same group share a color, with a legend built for you. Add an `r` and the dot grows into a bubble, so a third value rides along in the size.

### Trend and style

Turn on `showTrend` and the chart draws a least-squares line through the points, so a correlation reads at a glance. A per-point `color` overrides its category color; caption the axes with `xLabel` and `yLabel`, or pin the range with `xMin`/`xMax`/`yMin`/`yMax` instead of auto-fitting. Points, grid, and legend all scale to the box.

### Dynamic data, per render

```http
POST https://render.imejis.io/v1/<design-id>
{ "scatter.data": [
  { "x": 5,  "y": 12, "category": "Search" },
  { "x": 18, "y": 28, "category": "Search" },
  { "x": 22, "y": 26, "category": "Social" },
  { "x": 48, "y": 55, "category": "Social" }
] }
```

Point an image at the render URL and a correlation chart in a weekly report or a shared dashboard stays current on its own as you push fresh points.

### Try it

It's under Data in the editor palette, with a live playground on the [scatter component page](/components/scatter), or start from the free [scatter plot maker](/tools/scatter-plot-maker).