color

Adds a color picker input to your indicator’s Inputs panel. Users can choose a base color (from predefined constants) or a custom RGBA color. Ideal for customizing the look of plots, bands, and overlays.

Syntax

input.color(title, value, id?, group?, tooltip?, inline?)

Parameters

• title string — Label shown in the Inputs panel.

• value BaseColors | RGBAColor — Default color. Can be either:

  • BaseColors (predefined named colors like color.red, color.blue).

  • RGBAColor object { r, g, b, a } (where a is transparency 0–1).

• id string (optional) — Unique key for referencing this input. If omitted, auto-generated from title (lowercased, spaces removed).

• group string (optional) — Groups this input under a collapsible section.

• tooltip string (optional) — Small helper text shown on hover.

• inline string (optional) — Aligns multiple inputs in the same row if they share the same key.

Return Value

{ id: string } — The assigned id, either provided or auto-generated.

Example

//@version=1

// This is the setup function.
// Here you can define the input parameters for the indicator.
init = () => {
  // Example: Pick a base color
  input.color(
    'Line Color',
    color.blue,  // default color
    undefined,
    'Styles',
    'Choose the line color'
  );

  // Example: Pick a custom RGBA color
  input.color(
    'Background',
    { r: 255, g: 200, b: 50, a: 0.5 }, // semi-transparent orange
    undefined,
    'Styles',
    'Background color with transparency'
  );
}

// This is the main function. It is called every time a new candle is received.
// Here you can calculate the indicator values and draw the indicator on the chart.
onTick = (length, _moment, _, ta, inputs) => {

};

Result

Tips

• Use BaseColors when you want simple predefined colors; use rgba() when you need transparency.

• Tooltips are especially useful here—help users understand what element they are coloring (line, background, band).

Warning

If using RGBAColor, ensure values are in valid ranges: r, g, b = 0–255, a = 0–1. Out-of-range values may cause errors or unexpected colors.

Good Practice

• Group all styling-related inputs (like color, linewidth, linestyle) under a Styles section.

• Provide high-contrast default colors to ensure visibility on both dark and light chart themes.