Skip to main content



Sets the trace name. The trace name appears as the legend item and on hover.

In the Name text box, the name can be entered and formatted. This is automatically reflected in the Structure > Traces[link] section and in the legend[link] of the plot. The trace name can be also edited directly by double-clicking the trace name in the plot legend.

HTML tags and CSS formatting can be used to enrich text styling.

Trace Opacity#

Sets the opacity (transparency) of the trace.

Segment Colors#


Clicking on the colored bar next to "Colors" hides or reveals an extra menu, allowing the popup choice of these classes of color scales:

  • sequential scales Use sequential colorscales for data that smoothly changes value and has meaningful order.

  • divergent scales Use divergent colorscales for data that smoothly changes around a centerpoint (such as zero).

  • categorical scales Use categorical colorscales for data that has distinct groups and a non-meaningful order.

  • cyclical scales Use cyclical colorscales for data that has a natural cycle, such as angular, diurnal or seasonal data.

  • cubehelix scales Cubehelix colorscales are like sequential scales, but have the added benefit of printing clearly in black & white. Adjust the "start" slider to change the scale's base color. A cubehelix scale with 0 rotation transitions through a single base color. A scale with non-zero rotation "rotates" through other colors. Change the rotation slightly to add a touch of another color, change it more to create a scale with multiple colors.

  • cmocean scales cmocean colorscales are a mix of sequential and diverging scales. They were originally developed for oceanography data, but can be applied beautifully to any other type of data as well.

Extended Colors#

When more data than colors is present, the available colors in the chosen scale are exhausted; this has two solutions:

  • On prevent repetition by adding random colors.

  • Off reuses (repeats) the indicated colors.

Subplot Title#


The pie chart can have its own title, which is entered by filling text in the Subplot Title > Name field. The subplot title will be placed in the middle when Segment > Hole Size[link] is large enough, or atop the pie chart otherwise.


Shape, order and arrangement of the segments is set in this pane.


  • Sorted Segments can be sorted by size, starting with the largest segment working toward the smallest segment.

  • Unsorted takes the order of the grid rows for placing the segments.


  • Clockwise is the default direction when placing the segments (starting at 12 o'clock, unless Segments > Rotation is not zero)

  • Counterclockwise reverses the direction of the placement


To place the desired segment "at twelve o'clock", Rotation (in degrees) can be used. Positive numbers rotate clockwise, negative numbers rotate counterclockwise.

Hole Size#

The center of the pie chart can be blanked to make room for the Name[link] of the subplot. The text size of the subplot name will be scaled down as far as necessary and possible.


Padding of the pie segments is determined as fraction of two adjacent segments: larger segments cause larger gaps between segments.

Border Width#

Around each pie segment a border is placed increasing inward and outward size of the segment. On narrow Pull settings, this will join two segments by their border.

Border Color#

Only available when Border Width has a non-zero value.

The default color picker[link] is used to set the color of the segment border, if present.


Text added to the pie chart segments

Text Position#

Depending on choosing All or Custom various popups appear

  • All places all segment texts on the same relative position. * *Inside The segment text is placed inside the segment regardless of the available space in the plot. The text is placed horizontal in larger segments and aligned with the segment's rotation when space is scarce. This is set in the conditional popup Inside Text Orientation below. Outside places the segment text in the perimeter of the segment * *Auto uses inside when enough space is available and outside for small segments when utside the circle of the pie chart the rectangular chart area has enough space. None does not show any segment text in the plot

  • Custom This should[bug] position text values individually, according to the provided data positions array. The popup Data inlined in Figure appears and provides an option to chose a grid colum that holds combinations of [Top, Middle, Bottom] and [Left, Center,Right]


  • Values will display the values taken from the data grid as plain text.

    • Template shows an edit panel for the template string used for rendering the information text. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". Dates and times are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}".


Show or hide information of the pie segments. Contains a hidden Text option that is activated by chosing a grid column in Text below. Tick any you want:

  • Label shows the text as per grid text column

  • Value shows the absolute value from the grid cells

  • % displays the relative percentage of the segment

  • Text

    Only available when a text grid column has been chosen in Text below.


The grid column[link], holding the text to be shown for each item on hover, can be chosen here. Only data-containing columns can be selected.


HTML font family - the typeface that will be applied by the web browser. The web browser will only be able to apply a font if it is available on the system which it operates. Plotly has a set of standard fonts available on all platforms, containing Arial, Balto, Courier New, Droid Sans, Droid Serif, Droid Sans Mono, Gravitas One, Old Standard TT, Open Sans, Overpass, PT Sans Narrow, Raleway and Times New Roman.

Font Size#

Size of the typeface in pixels.

Font Color#

Specifies the color of the font, set using the default color picker[link]

Inside Text Orientation#

Only available when Text > Text Positions is set to inside.

The text is rotated according to the setting below. When not enough space is available, the text is shown in a smaller size, regardless of the ***Font Size*** set above.
  • Auto displays the segment text with a combination of horizontal, radial and tangential, whichever fits best.

  • Radial places the text aligned with the segment's axis, toward the center

  • Tangential places the text perpendicular to the segment's axis

  • Horizontal places the text horizontally


Scale Group#

If there are multiple pie charts that should be sized according to their totals, place every trace in the same group. Seems defunct[bug]: groups can be added and chosen but selecting from the popup returns to Select an Option***



  • Values tooltips will show actual data values on hover.
  • Template tooltips will show custom-formatted values on hover. This option also enables the template formatting field.


Show or hide information of the pie segments when being hovered over. Contains a hidden Text option that is activated by chosing a grid column in Text below. Tick any you want:

  • Percent displays the relative percentage of the segment

  • Label shows the text as per grid text column

  • Value shows the absolute value from the grid cells

  • Text

    Only available when a text grid column has been chosen in Text above.

  • Trace name

    Only available when a text grid column has been chosen in Text above.

Trace Name#

Only appears when Trace name is ticked in the Show menu

  • Clip To The trace name is partially shown in a side pane attached to the hover pane. Opens extra numerical data field.
  • No Clip An extra side-panel is added to the hover pane, showing the entire trace name.
  • Hide No trace name is shown in the hover info pane.
  • px Numerical field to enter the number of pixels the trace name will be clipped to, only appears when Clip To is selected.

Text Alignment#

Sets the horizontal alignment of the text content within the hover label box. Has an effect only if the hover label text spans two or more lines. Alignment of Hover/Tooltip can be set to Auto, Left or Right.