Skip to content

label namespace

The label namespace provides functions to draw text annotations anchored to bar coordinates. Labels can display values, status messages, or tooltips. Each call returns a handle you can update or delete later.

FunctionPurpose
label.new(x, y, text, xloc, yloc, color, style, textcolor)Create a label at (x, y).
label.set_x(id, x) / label.set_y(id, y)Move an existing label.
label.set_text(id, text)Update the caption.
label.set_style(id, style)Change label shape (arrow, circle, none).
label.set_color(id, color) / label.set_bgcolor(id, color) / label.set_textcolor(id, color)Adjust colors.
label.delete(id)Remove the label.
//@version=5
indicator("Label namespace example", overlay=true)
var label info = na
if barstate.islast
price = close
if na(info)
info := label.new(bar_index, price,
text = "Close: " + str.tostring(price, format.mintick),
style = label.style_label_left,
textcolor = color.white,
bgcolor = color.new(color.blue, 70))
else
label.set_x(info, bar_index)
label.set_y(info, price)
label.set_text(info, "Close: " + str.tostring(price, format.mintick))