Picta Settings

These fields are shown directly in the picta panel — more setting can be found in the section panels, which are covered in the Sections documentation.

Id

A text field that serves as the internal label for the picta panel. The Id does not appear in the chart itself — it's used to name the panel and as a reference key if the picta needs to be referenced from elsewhere in the settings.

Name

The display label that appears in the chart legend and tooltips. Rename it to something descriptive like "Revenue 2025" or "Market Share by Region".

Dataset

If your chart has multiple datasets (added from the Data panel), use this dropdown to select which dataset this picta should visualize. Any filters or sorting you've created in the Data panel also appear as separate entries in this dropdown — so you can choose a filtered or sorted version of a dataset for a specific picta without affecting others.

This dropdown is only shown when you have more than one dataset, or when you've added filters or sorting. If you have a single dataset with no filters or sorting, the picta uses it automatically and the Dataset field is hidden.

Smoothing

Available in the Line picta. Turns straight line segments into smooth, curved lines. Use this when you want to emphasize trends rather than exact point-to-point changes — it gives line charts a fluid, polished look.

Step

Available in the Line picta. Creates a stepped line that moves horizontally then vertically (or vice versa) between data points, like a staircase. Use this for data that changes at discrete intervals — for example, showing stock prices at the close of each trading day, or temperature readings taken hourly.

Orientation

Available in Tree, Funnel, and Sankey pictas. Controls whether the chart reads vertical (default) or horizontal (left-to-right). Switching to horizontal can be useful when you have many nodes or long labels that need more room to read comfortably.

Min and Max

Set custom minimum and maximum values for the chart scale. Use this to:

• Zoom in on a specific range — e.g., show values from 80 to 100 instead of 0 to 100
• Keep scales consistent across multiple charts in a dashboard so they're directly comparable
• Remove empty space above/below your data

Edge Shape

Available in the Tree picta. Controls how the connector lines between nodes are drawn. Choose between Curve (smooth, flowing arcs) or Polyline (straight, angular lines with right-angle turns). Curve gives a softer, organic look; Polyline is cleaner and more structured.

Tick Count

Sets how many tick marks appear on the gauge dial. Use a higher number for more precise readings, a lower number for a cleaner look.

Layout

Available in the Tree picta. Controls how the tree branches are arranged. Choose between:

• Orthogonal — the classic tree diagram with right-angle branches, organized top-to-bottom or left-to-right
• Radial — branches spread outward from a central root node, like a sunburst

Try both to see which layout makes your hierarchy easiest to read.

X-Axis Index

Only shown when your chart has multiple x-axes. You can set an Id on each x-axis to identify it, then use this dropdown to assign the picta to a specific x-axis by its Id.

Y-Axis Index

Only shown when your chart has multiple y-axes. You can set an Id on each y-axis to identify it, then use this dropdown to assign the picta to a specific y-axis by its Id.

Polar Index

Only shown when your chart has multiple polar coordinate systems. You can set an Id on each polar system to identify it, then use this dropdown to assign the picta to a specific one by its Id.

Leaf Depth

Available in the Treemap picta. Limits how many levels of the hierarchy are visible. For example, a LeafDepth of 2 shows parent and child levels but hides grandchildren. Use this to keep complex hierarchies readable.

Start Angle

Sets the angle (in degrees) where the first slice or element begins on circular charts like Pie, Sunburst, and Gauge. Zero degrees is at the 3 o'clock position (right), increasing counterclockwise by default. Use this to change where the first data point appears — for example, setting a start angle of 90° begins at the top. The up and down arrow buttons step in increments of 45 degrees, but you can type any number directly for precise control.

End Angle

Sets the angle (in degrees) where the last slice or element ends on circular charts like Pie, Sunburst, and Gauge. Together with Start Angle, this defines the angular span of the chart — use it to create partial circles or gauge arcs rather than full 360° rings. The up and down arrow buttons step in increments of 45 degrees, but you can type any number directly for precise control.

Pad Angle

Available in the Pie picta. Adds spacing between pie slices. A small gap between slices makes each segment visually distinct — useful when slices have similar colors or when you want to emphasize individual parts.

Coordinate System

Determines the coordinate system for the picta:

• Cartesian — the standard x-y grid (used by bar, line, scatter, etc.)
• Polar — circular coordinates (used by radar charts and polar bar charts)
• Geographic — for map-based visualizations (choropleth, bubble map)

Stack

Available in Line, Bar, and Scatter pictas. Stacks multiple series on top of each other. In a bar chart with multiple categories, stacking shows how each part contributes to the total. In line charts, stacking creates a stacked area effect.

To stack, set the same Stack name on all pictas you want to stack together.

Roaming

Available in Map, Tree, Treemap, Graph, Chord, and Sankey pictas. Controls how users can interact with the chart. Choose from four options:

• None — no zooming or panning. The chart is static.
• Scale — users can zoom in/out with the scroll wheel or pinch gesture, but cannot move the view.
• Move — users can drag to reposition the view, but cannot zoom.
• Scale and Move — users can zoom and drag freely to explore the chart.

Rose Type

Specific to pie charts. When enabled, the chart becomes a rose (nightingale) chart where each slice's radius corresponds to its value, not just the angle. This makes small values more visible and creates a distinctive visual style.

Bar Width

Available in Bar and Candlestick pictas. Controls how wide the bars are. Narrow bars work well when you have many categories; wider bars give a bolder look.

Bar Gap

Available in the Bar picta. Controls spacing between bars. Reduce the gap for a denser look, increase it for more breathing room between categories.

Size

Available in Pie, Map, Tree, Treemap, Graph, Chord, Funnel, Sankey, and Streamgraph pictas. Controls the size and position of the chart within its container. You can set:

• Width and Height — the overall dimensions of the chart
• Top, Bottom, Left, Right — padding/margins from the container edges

Use these settings to fine-tune how the chart fits in your layout, especially when embedding or placing it alongside other content.

For all other pictas (bar, line, scatter, etc.), size and position are controlled by the canvas grid element, because those pictas are drawn inside a grid rather than as standalone elements.

Show Shape

Available in the Line picta. Toggles shapes on data points. On by default — disable it for a clean, minimal line without shapes at each point.

Show Background

Available in the Bar picta. Displays a background behind bars. This can add visual depth, making foreground elements stand out more clearly.

Round Cap

Available in the Bar picta. When enabled, bars have rounded caps (rounded corners at the top) instead of flat ends. This gives the bars a softer, more polished appearance.

Avoid Label Overlap

Available in the Pie picta. Automatically repositions labels so they don't overlap each other. Great for pie charts with many slices where labels would otherwise crowd together.

Expand and Collapse

Available in Tree and hierarchical charts. When enabled, users can click nodes to expand or collapse their children. Essential for managing complex hierarchies with many levels.