# Drawings

Drawings (shapes) are the tools that can help you analyze the charts and make clear annotations to them.
The drawings toolbar is located on the left panel.
Follow the [Drawings List] article for a complete list of tools included in the drawing toolbar.

## Style customization

Each drawing tool has its own default properties, such as color and size, that users can change in the UI.

![Style customization](/img/drawings_style_customization.png)

You can also customize the drawing style using the API.
Refer to the [Drawing Overrides] article for more information.

## Drawing toolbar

You can show/hide the drawing toolbar on the fly as follows:

```javascript
widget.activeChart().executeActionById("drawingToolbarAction");
```

Note that the toolbar is hidden in the fullscreen mode. To display the toolbar, enable the [`side_toolbar_in_fullscreen_mode`] featureset.

### Favorite tools

You can specify a default list of favorite drawings using the [`favorites`](../../api/interfaces/Charting_Library.ChartingLibraryWidgetOptions.md#favorites) property in [Widget Constructor](https://charting-library-docs.xstaging.tv/latest/configuration/Widget-Constructor.md).

In the UI, users can mark drawings as favorites using the _Add to favorites_ button. The selected drawings are added to _Favorite Drawings Toolbar_ that appears on the chart.
If you do not want users to specify favorites, you should disable the [`items_favoriting`](../../customization/Featuresets.md#items_favoriting) featureset. As a result, the _Add to favorites_ button will be hidden in the UI.

![Favorite tool](/img/drawings_favorite_tool.png)

### Custom restrictions

You can hide some drawings from the toolbar or apply custom restrictions to the chart.
To do this, use the [`drawings_access`] property of [Widget Constructor].
For example, you can choose which tools will be shown to users or hidden/disabled from them.

![Disabling drawings](/img/drawings_custom_restrictions.png)

## Drawing features

### Templates

:::info

These feature is only available in [Trading Platform].

:::

Users can use the template appliance option for multiple drawings of the same type.
This option is available in the floating toolbar.
To disable this feature, include the `drawing_templates` [featureset] in the [`disabled_features`] array.

![Template](/img/drawings_template.png)

:::tip

To save drawing templates on your server, you can use the [predefined REST API] or implement [API handlers].

:::

## Drawing API

The library allows you to create and manage drawings using the built-in API. You can also combine drawings into groups and subscribe to drawing-related events. Refer to [Drawings API](https://charting-library-docs.xstaging.tv/latest/ui_elements/drawings/drawings-api.md) for more information.

[API handlers]: https://charting-library-docs.xstaging.tv/latest/saving_loading/save-load-adapter.md
[`disabled_features`]: https://charting-library-docs.xstaging.tv/latest/api/interfaces/Charting_Library.ChartingLibraryWidgetOptions#disabled_features
[`drawings_access`]: https://charting-library-docs.xstaging.tv/latest/api/interfaces/Charting_Library.ChartingLibraryWidgetOptions#drawings_access
[Drawings List]: https://charting-library-docs.xstaging.tv/latest/ui_elements/drawings/Drawings-List.md
[Drawing Overrides]: https://charting-library-docs.xstaging.tv/latest/customization/overrides/Drawings-Overrides.md
[featureset]: https://charting-library-docs.xstaging.tv/latest/customization/Featuresets.md
[predefined REST API]: https://charting-library-docs.xstaging.tv/latest/saving_loading/save-load-rest-api.md
[`side_toolbar_in_fullscreen_mode`]: https://charting-library-docs.xstaging.tv/latest/customization/Featuresets.md#side_toolbar_in_fullscreen_mode
[Trading Platform]: https://charting-library-docs.xstaging.tv/latest/trading_terminal.md
[Widget Constructor]: https://charting-library-docs.xstaging.tv/latest/configuration/Widget-Constructor.md

---

## 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)