---
source: https://qlik.dev/embed/nebula/customize/visualizations/sn-distributionplot/
last_updated: 2025-07-08T16:09:30Z
---

# Creating distribution plot charts

> **Note:** Where possible, use [qlik-embed](https://qlik.dev/embed/qlik-embed/) and [qlik/api](https://qlik.dev/toolkits/qlik-api) rather than this framework.

The distribution plot is suitable for comparing
range and distribution for groups of numerical data.
Data is plotted as value points along an axis.

Learn more about the [distribution plot](https://qlik.dev/embed/foundational-knowledge/visualizations/distributionplot),
or review the [distribution plot API specification](https://qlik.dev/apis/javascript/sn-distributionplot/).

In a distribution plot you need to use one or two dimensions, and one measure.
If you use a single dimension you receive a single line visualization.
If you use two dimensions,
you get one line for each value of the second, or outer, dimension.

[image: Distribution plot chart example]

```js
// 'app' is an enigma app model
const embeddable = embed(app, {
  types: [
    {
      // register distribution plot chart
      name: "distributionplot",
      load: () => Promise.resolve(distributionplot),
    },
  ],
});

embeddable.render({
  element,
  type: "distributionplot",
  fields: ["Product Sub Group", "Product Group", "=Avg(Sales)"],
});
```

## Requirements

Requires `@nebula.js/stardust` version `1.4.0` or later.

## Installing

If you use npm: `npm install @nebula.js/sn-distributionplot`.
You can also load through the script tag directly from
[https://unpkg.com](https://unpkg.com/@nebula.js/sn-distributionplot).

## More examples

### Vertical distribution plot

Setting `orientation` property value to `vertical`. Default value is `horizontal`.

[image: Vertical distribution plot chart example]

```js
embeddable.render({
  element,
  type: "distributionplot",
  fields: ["Product Sub Group", "Product Group", "=Avg(Sales)"],
  // overrides default properties
  properties: {
    orientation: "vertical",
  },
});
```

### Different ways to present distribution plot

#### Points only

Displays value points only.

[image: distribution plot chart display only points example]

```js
embeddable.render({
  element,
  type: "distributionplot",
  fields: ["Product Sub Group", "Product Group", "=Avg(Sales)"],
  // overrides default properties
  properties: {
    presentation: {
      visibleComponents: "points",
    },
  },
});
```

#### Background only

Displays a bounding box showing the range of the values only.

[image: distribution plot chart display only background example]

```js
embeddable.render({
  element,
  type: "distributionplot",
  fields: ["Product Sub Group", "Product Group", "=Avg(Sales)"],
  // overrides default properties
  properties: {
    presentation: {
      visibleComponents: "box",
    },
  },
});
```

#### Bubble size and jitter

You can adjust the size of the bubbles
that illustrate the value points by setting `bubbleScales` value.

You can set `displacement` to `jitter` to jitter several overlapping value points.
This moves some of the points slightly to create a larger footprint
that shows that there are more than one value behind the point.

[image: distribution plot chart example with
customized bubble sizes and jitter displacement]

```js
embeddable.render({
  element,
  type: "distributionplot",
  fields: ["Product Sub Group", "Product Group", "=Avg(Sales)"],
  // overrides default properties
  properties: {
    dataPoint: {
      bubbleScales: 90,
      displacement: "jitter",
    },
  },
});
```