rectangle

Draws a Rectangle using a starting time/price and an ending time/price. Great for marking supply/demand zones, fair value gaps, or consolidation areas. Supports fill, extension, labels, and even a midline inside the box.

Syntax (one line)

rectangle(startTime, topPrice, endTime, bottomPrice, styles?, text?)

Parameters

startTime (number) · Left edge time of the rectangle. topPrice (number) · Upper price boundary. endTime (number) · Right edge time of the rectangle. bottomPrice (number) · Lower price boundary. styles (RectangleLineToolOverrides) · Customize the appearance:

• backgroundColor (RGBAColor | BaseColors) · Fill color.

• color (RGBAColor | BaseColors) · Border color.

• extendLeft (boolean) · Extend the box to the left.

• extendRight (boolean) · Extend the box to the right.

• fillBackground (boolean) · Fill inside the box.

• linewidth (number) · Border thickness.

• middleLine (object) · Optional midline: { lineColor, lineStyle, lineWidth, showLine }.

• showLabel (boolean) · Show a label text inside the rectangle.

• textColor (RGBAColor | BaseColors) · Label text color.

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

• fontSize, bold, italic, horzLabelsAlign, vertLabelsAlign for label control. text (string) · Optional text shown if showLabel is true.

Return Value

(string) · The ID of the created rectangle.

Example

What this does: Every 40 bars, draws a light green rectangle covering a recent range, extended to the right, with a label.

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

onTick = () => {
  if (index % 40 === 0) {
    // Style settings
    const style = {
      color: color.green,                       // border
      backgroundColor: color.rgba(0, 255, 0, 0.2),
      fillBackground: true,
      linewidth: 2,
      extendRight: true,
      transparency: 80,
      showLabel: true,
      textColor: color.green,
      fontSize: 12,
      bold: true
    };

    // Draw rectangle from bar -10 to bar 0
    rectangle(
      time(10),     // start time
      high(10),     // top price
      time(0),      // end time
      low(0),       // bottom price
      style,
      "Demand Zone" // optional label
    );
  }
};

Tips

• Use extendRight to project supply/demand zones into the future.

• Keep high transparency so price action remains visible.

• Add a middleLine to track the mid-level of the zone.

Warning

• Very narrow rectangles may be hard to read.

• If showLabel is true, pass a short text to avoid overlap with candles.

Good Practice

• Reuse a fixed style set for demand vs supply (e.g., green vs red) for clarity.

• Store your styles in a const object and reuse them to keep scripts tidy.