polyline

Draws a Polyline by connecting multiple points with straight segments. It’s perfect for outlining custom zones, sketching patterns, or tracing price swings. You can optionally fill the interior to make areas stand out.

Syntax (one line)

polyline(points, styles?)

Parameters

points (PricedData[]) · Array of points (each with time & price) that define the connected segments. styles (PolylineLineToolOverrides) · Visual and fill options:

• backgroundColor (RGBAColor | BaseColors) · Fill color for the interior.

• fillBackground (boolean) · Turn background fill on/off.

• filled (boolean) · Close the shape and fill it (if fillBackground is true).

• linecolor (RGBAColor | BaseColors) · Line color for the outline.

• linestyle (number) · 0=solid, 1=dotted, 2=dashed…

• linewidth (number) · Outline thickness.

• transparency (number) · 0–100 fill transparency (higher = lighter).

Return Value

(string) · The drawing ID of the created Polyline.

Example

What this does: Every 44 candles, it traces a simple 3-point polyline around a recent swing and softly fills the area. All visuals live in one const style.

//@version=1
init = () => {
  indicator({ onMainPanel: true, format: 'inherit' });
};

onTick = () => {
  if (index % 44 === 0) { // draw occasionally to keep charts clean
    // 1) Define the outline points
    const pts = [
      newPoint(time(80), high(80)),   // point A
      newPoint(time(55), low(55)),    // point B
      newPoint(time(30), closeC(30))  // point C
    ];

    // 2) Style (PolylineLineToolOverrides)
    const style = {
      linecolor: color.orange,
      linestyle: 0,
      linewidth: 2,
      fillBackground: true,
      filled: true, // close and fill the shape
      backgroundColor: color.rgba(255, 165, 0, 0.18),
      transparency: 82
    };

    // 3) Draw the polyline
    polyline(pts, style);
  }
};

Tips

• Add more points to follow complex swings, but keep shapes simple for readability.

• For zones, set filled: true and use a high transparency so candles remain visible.

Warning

• Very dense polylines can clutter the chart—avoid adding unnecessary points.

Good Practice

• Use a consistent color for outline vs fill across all your custom shapes.

• Keep a reusable const style and only tweak linecolor/backgroundColor per scenario.