Skip to main content

Customization overview

The library provides extensive customization options through multiple APIs. This overview article will walk you through customizing the chart's appearance and functionality.

Customization APIs

  • Overrides. Customize elements on the chart like panes, scales, series, studies, drawings, and more.
  • Custom themes API. Create your own theme with a custom color palette.
  • Featuresets. Show/hide UI elements and modify chart interaction behavior. For example, you can enable the support of resolutions in ticks or disable chart scrolling.
  • Widget Constructor. Customize the chart size, list featuresets and overrides, set up a theme, and more.
tip

Discover the order in which different approaches affect your chart's appearance in the Customization precedence article.

UI elements

Refer to the UI elements section for more details on drawings, indicators, marks, and other elements.

Theme

The library supports dark and light themes. Use the theme parameter in Widget Constructor to specify a theme. The default value is light. The chart layout does not contain buttons that switch the theme in the UI. Therefore, users cannot switch the theme unless you develop this option outside the library.

You should switch the chart's theme when the theme of your website changes. To do this, use the changeTheme method that changes the theme on the fly.

Note that the theme value is stored in the chart's configuration. Therefore, if you restore the chart that has the dark theme, you may see a black chart background in the light theme. In this case, you should apply the theme once again using the changeTheme method.

tip

If you want to override the default colors of the light and dark themes, you can use the Custom themes API.

Language

The library supports a variety of languages. For more information, refer to the Localization article.

The visibility of the TradingView logo depends on the terms of your license agreement. Contact your TradingView account manager for more information.

Price formatting

Refer to the Price Format paragraph for information on how to customize the price format.

Non-customizable components

You cannot customize icons on the toolbars.

Custom components

The library does not support injecting custom UI components. If you want to add a UI component, implement it outside the library.