# Marks

Marks allow you to display some extra information like news, bar patterns, splits/dividends, and more [on the chart](#marks-on-the-chart) or [time scale](#marks-on-the-time-scale).

Use the [`subscribe`](../api/interfaces/Charting_Library.IChartingLibraryWidget.md#subscribe) method to handle events raised when users interact with marks. You can also [refresh](https://charting-library-docs.xstaging.tv/latest/api/interfaces/Charting_Library.IChartWidgetApi#refreshmarks) and [clear](https://charting-library-docs.xstaging.tv/latest/api/interfaces/Charting_Library.IChartWidgetApi#clearmarks) marks using the chart methods.

## Marks on the chart

Marks on the chart are circles that are attached to bars and contain a character inside. You can customize the circle size and color. If you want to display two characters (like 'ED', 'AB', 'CD', etc.), you should enable the [`two_character_bar_marks_labels`](../customization/Featuresets.md) featureset.

One bar can have several marks. When a user hovers over the mark on desktop or taps it on a touch device, a tooltip appears. The tooltip contains plain text only and does not support HTML code. However, in [Trading Platform](https://charting-library-docs.xstaging.tv/latest/trading_terminal.md) you can render fully custom tooltip content — styled text, links, images, and more — with your own web component. Refer to the [Customize mark tooltips](https://charting-library-docs.xstaging.tv/latest/tutorials/how-to-guides/customize-mark-tooltips.md) guide for more information.

You can also enable the [`pin_bar_mark_tooltips_on_click`](../customization/Featuresets.md#pin_bar_mark_tooltips_on_click) featureset to reveal the tooltip on click instead of on hover and keep it pinned open.

![Marks](/img/marks.png)

Marks are requested from your datafeed if you set [`supports_marks`](../api/interfaces/Charting_Library.DatafeedConfiguration.md#supports_marks) to `true`. The library calls [`getMarks`](../connecting_data/datafeed-api/additional-methods.md#getmarks) or requests [/marks](https://charting-library-docs.xstaging.tv/latest/connecting_data/UDF.md#marks-on-the-chart) to get mark data for the visible data range.

## Marks on the time scale

Marks on the time scale are figures above the time scale. Each mark has a character inside and a pop-up tooltip with information strings. The tooltip does not support HTML code. However, in [Trading Platform](https://charting-library-docs.xstaging.tv/latest/trading_terminal.md) you can render fully custom tooltip content — styled text, links, images, and more — with your own web component. Refer to the [Customize mark tooltips](https://charting-library-docs.xstaging.tv/latest/tutorials/how-to-guides/customize-mark-tooltips.md) guide for more information.

You can specify a time scale mark shape using the [`shape`](../api/interfaces/Charting_Library.TimescaleMark.md#shape) property. Images can be displayed within time scale marks by providing an image URL in the [`imageUrl`](../api/interfaces/Charting_Library.TimescaleMark.md#imageurl) property.

![Timescale marks](/img/timescale_marks.png)

Time scale marks are requested from your datafeed if you set [`supports_timescale_marks`](../api/interfaces/Charting_Library.DatafeedConfiguration.md#supports_timescale_marks) to `true`. The library calls [`getTimescaleMarks`](../connecting_data/datafeed-api/additional-methods.md#gettimescalemarks) or requests [/timescale_marks](https://charting-library-docs.xstaging.tv/latest/connecting_data/UDF.md#time-scale-marks) to get mark data for the visible data range.

## Example

See the Pen 
  UI. Marks on chart and time scale  by TradingView (@tradingview)
  on CodePen.

---

## Sitemap

- [All documentation pages](https://charting-library-docs.xstaging.tv/llms.txt)
- [Full page map with headings](https://charting-library-docs.xstaging.tv/docs_map.md)