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.
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.
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.
TradingView logo
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.