Plots

How do you show a script's values on the chart? Call plot with a series for a line, plotshape or plotchar for a mark on the bars where a condition holds, hline for a fixed level, fill between two of those, and bgcolor or barcolor to colour the chart behind or on each bar. Each call draws one point per bar it runs on, and a na value or colour leaves that bar empty.

//@version=6
indicator("Trend colours", overlay = true)
float ma = ta.ema(close, 50)
bool up = close > ma
// A colour worked out per bar colours each bar's piece of the line on its own.
p1 = plot(ma, "EMA 50", color = up ? color.teal : color.red, linewidth = 2)
p2 = plot(close, "Close", display = display.none)
fill(p1, p2, color = up ? color.new(color.teal, 85) : color.new(color.red, 85))
bgcolor(ta.cross(close, ma) ? color.new(color.yellow, 80) : na,
      title = "Crosses")

Plots draw on the price pane when the declaration says overlay = true, and in the script's own pane otherwise. On a run that only computes, such as a sweep or a screen, plots aren't drawn and their arguments don't run, unless something in them can change what the run computes. In leak-safe AmenoScript a negative offset stops the script, since it draws each bar's value on a bar before it, and a Pine text gets a warning. See plots.

plot

Pine v6

plot(series, title, color, linewidth, style, trackprice, histbase, offset, join, editable, show_last, display, format, precision, force_overlay, linestyle) → plot

Draws a series as a line, histogram, area, columns or marks, and returns a reference fill can take.

A value of na, or 1e100 and beyond in either direction, leaves the bar empty, while the script still reads the value. A colour that isn't a literal is worked out on every bar, so each bar's piece can differ, and a na colour leaves that piece undrawn. Two plots with one title both draw: the second keeps its own key. A plot whose display has no pane bit, display.none or display.data_window, isn't drawn, but fill can still use it and the data window still lists it. A plot with editable = false has no row in the study's Style settings.

Parameter	Default	Description
series series int/float		The values to draw.
title const string		The plot's name in the legend, the settings and the data window.
color series color	#2962FF	A fixed colour, or one worked out per bar.
linewidth input int	1	The line's width in pixels.
style input plot_style	plot.style_line	One of the plot.style_* values below.
trackprice input bool	false	true draws a horizontal line at the last value across the pane.
histbase input int/float	0	The level histograms, columns and areas start from.
offset series int	0	Shifts the plot this many bars right, or left when negative.
join input bool	false	true joins the marks of plot.style_circles and plot.style_cross with a line.
editable const bool	true	false leaves the plot out of the Style settings.
show_last input int		Draws only the last this-many bars.
display input plot_display	display.all	Where the plot shows: see display.*. Without the pane bit, it isn't drawn.
format input string		How its values read: format.price, format.percent, format.volume or format.mintick. Left out, the declaration's.
precision input int		The decimals its values show, up to 16.
force_overlay const bool	false	true draws it on the price pane whatever the declaration says.
linestyle input plot_linestyle	plot.linestyle_solid	plot.linestyle_dashed or plot.linestyle_dotted dashes the line.

plot.style_*

Values for plot's style.

Each is a const plot_style.

Name	What it means
plot.style_area	A filled area from histbase.
plot.style_areabr	A filled area that breaks at na.
plot.style_circles	A circle at each value.
plot.style_columns	A column from histbase to each value.
plot.style_cross	A cross at each value.
plot.style_histogram	A bar from histbase to each value.
plot.style_line	A line through every value, bridging na.
plot.style_linebr	A line that breaks at na.
plot.style_stepline	Steps from value to value.
plot.style_stepline_diamond	Steps with a diamond at each value.
plot.style_steplinebr	Steps that break at na.

plot.linestyle_*

Values for plot's linestyle.

Each is a string.

Name	What it means
plot.linestyle_dashed	A dashed line.
plot.linestyle_dotted	A dotted line.
plot.linestyle_solid	An unbroken line.

display.*

Values for a plot's display: the places it shows. Each is a whole number with one bit, so they add and subtract: display.all - display.status_line shows everywhere but the legend.

Name	Type	What it means
display.all	const plot_simple_display	Everywhere.
display.data_window	const plot_display	Listed in the data window.
display.none	const plot_simple_display	Nowhere. The plot isn't drawn, though fill can still use it.
display.pane	const plot_display	Drawn in its pane.
display.pine_screener	int	Shown in TradingView's Pine Screener. The Screener here doesn't read it, and lists every plot.
display.price_scale	const plot_display	Its last value labelled on the price scale.
display.status_line	const plot_display	Shown in the legend.

plotshape

Pine v6

plotshape(series, title, style, location, color, offset, text, textcolor, editable, size, show_last, display, format, precision, force_overlay) → void

Draws a shape on each bar where series is true, or where it isn't na at location.absolute.

Parameter	Default	Description
series series int/float/bool		When to draw: true, or a value at location.absolute.
title const string		The shape's name in the legend and the data window.
style input string	shape.xcross	A shape.* value, such as shape.triangleup, shape.circle or shape.labeldown.
location input string	location.abovebar	location.abovebar, location.belowbar, location.top, location.bottom, or location.absolute to place it at the series' value.
color series color	#2962FF	The shape's colour. A na colour draws nothing on that bar.
offset series int	0	Shifts the shapes this many bars.
text const string	""	Text beside the shape.
textcolor series color		The text's colour.
editable const bool	true	false leaves it out of the Style settings.
size const string	size.auto	size.tiny, size.small, size.normal, size.large, size.huge or size.auto.
show_last input int		Draws only the last this-many bars.
display input plot_display	display.all	Where it shows.
format input string		How its value reads in the data window.
precision input int		The decimals its value shows.
force_overlay const bool	false	true draws it on the price pane.

shape.*

Values for plotshape's style.

Each is a const string.

Name	What it means
shape.arrowdown	An arrow pointing down.
shape.arrowup	An arrow pointing up.
shape.circle	A circle.
shape.cross	A plus sign.
shape.diamond	A diamond.
shape.flag	A flag.
shape.labeldown	A label box with its tail pointing down.
shape.labelup	A label box with its tail pointing up.
shape.square	A square.
shape.triangledown	A triangle pointing down.
shape.triangleup	A triangle pointing up.
shape.xcross	An X.

location.*

Values for plotshape's and plotchar's location: where on each bar the mark goes.

Each is a const string.

Name	What it means
location.abovebar	Above the bar's high.
location.absolute	At the value of series, read as a price.
location.belowbar	Below the bar's low.
location.bottom	At the bottom of the pane.
location.top	At the top of the pane.

plotchar

Pine v6

plotchar(series, title, char, location, color, offset, text, textcolor, editable, size, show_last, display, format, precision, force_overlay) → void

Draws a character on each bar where series is true, or where it isn't na at location.absolute.

Parameter	Default	Description
series series int/float/bool		When to draw.
title const string		Its name in the legend and the data window.
char input string	"★"	The character to draw.
location input string	location.abovebar	Where on the bar, as for plotshape.
color series color	#2962FF	The character's colour.
offset series int	0	Shifts the marks this many bars.
text const string	""	Text beside the character.
textcolor series color		The text's colour.
editable const bool	true	false leaves it out of the Style settings.
size const string	size.auto	The character's size.
show_last input int		Draws only the last this-many bars.
display input plot_display	display.all	Where it shows.
format input string		How its value reads in the data window.
precision input int		The decimals its value shows.
force_overlay const bool	false	true draws it on the price pane.

plotarrow

Pine v6

plotarrow(series, title, colorup, colordown, offset, minheight, maxheight, editable, show_last, display, format, precision, force_overlay) → void

Draws an up arrow where series is positive and a down arrow where it is negative, longer the larger the value. Zero and na draw nothing.

Parameter	Default	Description
series series int/float		The values whose sign picks the arrow.
title const string		Its name in the legend and the data window.
colorup series color	#00FF00	The up arrows' colour.
colordown series color	#FF0000	The down arrows' colour.
offset series int	0	Shifts the arrows this many bars.
minheight input int	5	The shortest arrow, in pixels.
maxheight input int	100	The longest arrow, in pixels.
editable const bool	true	false leaves it out of the Style settings.
show_last input int		Draws only the last this-many bars.
display input plot_display	display.all	Where it shows.
format input string		How its value reads in the data window.
precision input int		The decimals its value shows.
force_overlay const bool	false	true draws it on the price pane.

plotcandle

Pine v6

plotcandle(open, high, low, close, title, color, wickcolor, editable, show_last, bordercolor, display, format, precision, force_overlay) → void

Draws candles from four series of your own. A bar where any of the four is na draws no candle.

Parameter	Default	Description
open series int/float		The candles' opens.
high series int/float		The candles' highs.
low series int/float		The candles' lows.
close series int/float		The candles' closes.
title const string		Its name in the legend and the data window.
color series color	#2962FF	The bodies' colour, fixed or per bar.
wickcolor series color		The wicks' colour.
editable const bool	true	false leaves it out of the Style settings.
show_last input int		Draws only the last this-many bars.
bordercolor series color		The bodies' border colour.
display input plot_display	display.all	Where it shows.
format input string		How its values read.
precision input int		The decimals its values show.
force_overlay const bool	false	true draws it on the price pane.

plotbar

Pine v6

plotbar(open, high, low, close, title, color, editable, show_last, display, format, precision, force_overlay) → void

Draws OHLC bars from four series of your own. A bar where any of the four is na draws nothing.

Parameter	Default	Description
open series int/float		The bars' opens.
high series int/float		The bars' highs.
low series int/float		The bars' lows.
close series int/float		The bars' closes.
title const string		Its name in the legend and the data window.
color series color	#2962FF	The bars' colour, fixed or per bar.
editable const bool	true	false leaves it out of the Style settings.
show_last input int		Draws only the last this-many bars.
display input plot_display	display.all	Where it shows.
format input string		How its values read.
precision input int		The decimals its values show.
force_overlay const bool	false	true draws it on the price pane.

hline

Pine v6

hline(price, title, color, linestyle, linewidth, editable, display) → hline

Draws a horizontal line across the pane at a fixed price, and returns a reference fill can take. A na price draws nothing.

Parameter	Default	Description
price input int/float		The level.
title const string		Its name in the settings.
color input color	#787B86	The line's colour.
linestyle input hline_style	hline.style_dashed	hline.style_solid, hline.style_dotted or hline.style_dashed.
linewidth input int	1	The line's width in pixels.
editable const bool	true	false leaves it out of the Style settings.
display input plot_simple_display	display.all	Without the pane bit, the line starts hidden.

hline.style_*

Values for hline's linestyle.

Each is a const hline_style.

Name	Value	What it means
hline.style_dashed	2	A dashed line, the default.
hline.style_dotted	1	A dotted line.
hline.style_solid	0	An unbroken line.

fill

Pine v6

fill(plot1, plot2, color, title, editable, show_last, fillgaps, display) → void
fill(plot1, plot2, top_value, bottom_value, top_color, bottom_color, title, display, fillgaps, editable) → void
fill(hline1, hline2, color, title, editable, fillgaps, display) → void

Colours the space between two plots or two hlines, with one colour per bar or a vertical gradient.

The plain form takes color, worked out per bar. The gradient form takes top_value and bottom_value with top_color and bottom_color, and colours from one to the other between those levels. A na colour leaves that bar's piece empty. A fill on a display with no pane bit draws nothing. When a reference doesn't name a plot or hline, the run warns and nothing is filled.

Parameter	Default	Description
plot1 plot		The first plot.
plot2 plot		The second plot.
color series color		The fill's colour, fixed or per bar. Left out, a pale blue.
title const string		Its name in the settings.
editable const bool	true	false leaves it out of the Style settings.
show_last input int		Fills only the last this-many bars.
fillgaps const bool	false	true bridges bars where a plot is na.
display input plot_simple_display	display.all	Where it shows.
top_value series int/float		The gradient's top level, per bar.
bottom_value series int/float		The gradient's bottom level, per bar.
top_color series color		The colour at top_value.
bottom_color series color		The colour at bottom_value.
hline1 hline		The first hline, in the hline form.
hline2 hline		The second hline, in the hline form.

bgcolor

Pine v6

bgcolor(color, offset, editable, show_last, title, display, force_overlay) → void

Colours the background of each bar's whole slot. A na colour leaves that bar's background as it is.

Parameter	Default	Description
color series color		The colour for this bar.
offset series int	0	Shifts the colours this many bars.
editable const bool	true	false leaves it out of the Style settings.
show_last input int		Colours only the last this-many bars.
title const string		Its name in the settings.
display input plot_simple_display	display.all	Without the pane bit, it starts hidden.
force_overlay const bool	false	true colours the price pane.

barcolor

Pine v6

barcolor(color, offset, editable, show_last, title, display) → void

Colours the chart's own candles. A na colour leaves a candle as it is.

The bar still forming takes its colour too, as on TradingView, and offset moves the colour onto another bar. A bar the offset pushes off the chart colours nothing.

Parameter	Default	Description
color series color		The colour for this bar.
offset series int	0	Colours the bar this many bars away instead.
editable const bool	true	false leaves it out of the Style settings.
show_last input int		Colours only the last this-many bars.
title const string		Its name in the settings.
display input plot_simple_display	display.all	Without the pane bit, nothing is coloured.

See also

• Plots in the guide
• Drawings: label, line, box
• color