# Widgets theme builder

**Widgets theme builder** is a standalone web application designed to help you customize the appearance of TradingView [Web Component-based widgets](https://www.tradingview.com/widget-docs/widget-formats.md).

[Open theme builder](https://widgets.tradingview-widget.com/theme-builder/)

Unlike standard widget constructors that focus on one widget at a time,
the theme builder allows you to design a **unified theme** and see it applied across multiple widget types (charts, tickers, and maps) simultaneously.

*Image: Widget theme builder*

Because [themes](https://www.tradingview.com/widget-docs/tutorials/web-components/styling-and-themes.md) are built using standard CSS, you have complete control over their scope.
You can apply a theme to your **entire page**, restrict it to **specific sections**, or target **individual widgets**.
This flexibility also allows you to set a global theme and then override specific styles for a single widget when needed.

:::info

The widgets theme builder is a new tool currently in active development.
We are already planning future updates and would love to hear your [feedback or feature requests](https://www.tradingview.com/widget-docs/contact/).

:::

## Interface overview

The builder is divided into three main areas:

- **Header** (top): switch between saved themes and step through your edit history with undo and redo.
- **Preview** (left): a live area where changes appear instantly. You can view your theme across several widgets simultaneously.
- **Settings** (right): your control panel. This is where you adjust colors and fonts, and manage the preview environment.

*Image: Widget theme builder*

## How to build your theme

Ready to start? Open the [**theme builder**](https://widgets.tradingview-widget.com/theme-builder/) and follow along with the steps below.

### 1. Set up light and dark modes

The *Light/Dark* switch at the top of the preview panel toggles the environment.
By default, *Light* and *Dark* modes are independent.
This means a color change made while *Light* is selected will not affect the *Dark* version of the theme, and the other way around.
This allows you to ensure perfect contrast and readability for both environments.

If you prefer to have the same colors applied to both modes simultaneously:

1. Click *Settings* button () next to the *Basic/Advanced* tabs.
2. Go to *Mode settings* and disable *Separate dark/light customizations*.
   Now, any color you pick applies to **both** modes.

### 2. Choose customization level

On the settings panel, you can switch between these two tabs at any time without losing your progress:

- **Basic** is best for quick changes. Changing one value automatically calculates related hues and opacities for the full theme.
- **Advanced** is best for detailed styling. This allows you to fine-tune specific elements like borders or individual CSS parts.

Note that **Advanced settings have higher precedence** than Basic settings.

:::success[Tip]

Start by adjusting the *Basic* settings to match your brand as closely as possible.
Once the foundation is set, use the *Advanced* section to tweak specific colors or details.

:::

### 3. Fine-tune the visuals

Every change you make is applied instantly to the preview.
Use the **Undo** and **Redo** buttons in the header to step back or forward through your edits.

Your work is saved automatically to your browser, so your progress is preserved if you refresh or close the tab.

### 4. Save and manage multiple themes

Click the theme name in the header to open the theme menu. From here you can:

- *Create new theme* — start a fresh theme alongside your existing ones.
- *Make a copy* — duplicate the current theme as a starting point for a variation.
- *Rename* — give the theme a meaningful name.
- *Switch themes* — the *Recently used* list lets you jump between saved themes instantly.
- *Import from CSS file* — load a theme you previously exported to continue editing it, even from a different device or browser.

### 5. Export and apply your theme

1. Click *Download* in the bottom right to get a CSS file, or select *Copy to clipboard* from the dropdown menu. You can also use *Download as CSS file* from the theme menu in the header.
2. Paste the code into a `<style>` tag in your HTML.
3. Apply the CSS prefix to the desired container in your HTML.
   For more details on scoping and theme implementation, see [Set styles and themes](https://www.tradingview.com/widget-docs/tutorials/web-components/styling-and-themes.md).

If you want to start over, click *Reset* to return to the original TradingView theme.

## Important to note

- This builder is specifically designed for TradingView widgets of the [**Web Component format**](https://www.tradingview.com/widget-docs/widget-formats.md). It is not compatible with iframe-based widgets.
- Your themes are stored in your browser's local storage. To use a theme on a different device or browser, export it and then import the CSS file there.

## What's next

We are already planning future updates, including preset example themes.

**We value your input!** As we continue to evolve this product, [share your feedback with us](https://www.tradingview.com/widget-docs/contact/).

---

## Sitemap

- [All documentation pages](https://www.tradingview.com/widget-docs/llms.txt)
- [Full page map with headings](https://www.tradingview.com/widget-docs/docs_map.md)
