> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wisdom.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Dual-Axis Charts

Dual-Axis Charts, also known as combo charts, are visualizations that combine multiple chart types or Y-axes into a single view. They allow you to display measures with different scales or units, such as absolute revenue alongside a percentage margin, by rendering each measure as a different series type.

This feature ensures that metrics with different semantic meanings remain readable and helps you identify relationships among data points that a single axis might obscure. This guide explains how the system detects when a dual-axis chart is needed and how these charts are structured.

## How it works

The system uses specific detection methods and structural components to build these rich visualizations.

### Detection methods

The system identifies the need for a dual-axis chart in two ways:

* **Rule-based:** It recognizes keywords such as "combo chart," "dual axis," or "dual-axis" in your query.
* **LLM-based:** The AI automatically detects when requested measures use different scales or have different semantic meanings.

### Chart structure

Each dual-axis chart is built using a specific layout specification:

* **Dual Y-axes:** Independent scales are provided for both the left and right Y-axes.

<Frame>
  <img src="https://mintcdn.com/wisdomai/USNcpoUKeVA3mEEU/images/dual-axis-chart.png?fit=max&auto=format&n=USNcpoUKeVA3mEEU&q=85&s=ac1a48724e5212bf224f165c3796030a" alt="Dual Axis Chart" width="800" height="620" data-path="images/dual-axis-chart.png" />
</Frame>

* **Multiple Series Types:** Each measure can be rendered as a **COLUMN** (vertical), **BAR** (horizontal), **LINE**, or **AREA**.
* **Layout Mapping:** The system explicitly defines what data appears on the X-axis, which measures belong to each Y-axis, and the rendering position for each series. The chart structure is defined using **ChartLayoutSpec**, which includes:
  * **x\_axis.columns\[]** - What goes on the X-axis
  * **y\_axes\[].columns\[]** - Measures per Y-axis
  * **y\_axes\[].series\_type** - How to render (column/line/bar/area)
  * **y\_axes\[].position** - Left or right axis
  * **series\_dimension** - Dimension for colored series grouping

## Key capabilities

Dual-Axis Charts allow you to perform advanced analysis within a single visualization:

* **Compare Different Scales:** View metrics with entirely different units, like transaction volume and conversion rates, in one place.
* **Mix Visual Styles:** Combine bars and lines to distinguish between volume-based data and efficiency-based trends.
* **Consolidate Insights:** Replace multiple standalone charts with a single visual that tells a more complete story.

## Common use cases

| Metric A (Bars/Area) | Metric B (Line) | Purpose                                                  |
| :------------------- | :-------------- | :------------------------------------------------------- |
| Revenue              | Margin %        | Compare absolute profit to efficiency.                   |
| Transaction Volume   | Conversion Rate | Track activity alongside success rates.                  |
| Pipeline Size        | Win Rate        | Monitor potential revenue against closing effectiveness. |
| Spend                | ROI             | Visualize investment against return levels.              |

## Targeted users

This feature is available to **Explorers** and **Admins**.

## FAQs

<AccordionGroup>
  <Accordion title="Do I need to configure axes manually?">
    No. The system automatically chooses the appropriate axes and chart types based on the detected metrics.
  </Accordion>

  <Accordion title="Can I mix different chart styles?">
    Yes. Combo charts can combine bars, lines, or area series within a single visualization.
  </Accordion>

  <Accordion title="When should I use a combo chart?">
    Use a combo chart when you need to compare metrics on different scales or when you want to see how two distinct trends relate.
  </Accordion>

  <Accordion title="Will this work with time series data?">
    Yes. Dual-axis charts are particularly effective for making time-based comparisons across multiple metrics.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card icon="chart-mixed" href="/advanced-features/visualization-types-and-properties" title="Visualization Types">
    Explore the full library of chart types and properties available in WisdomAI.
  </Card>

  <Card icon="flask" href="/new-releases/february-2026/knowledge-playground" title="Knowledge Playground">
    Experiment with different queries to see how the system generates dual-axis charts.
  </Card>
</CardGroup>