Legend Mapping
Map a Legend to a charting component so users can identify series/categories and (if supported) interact with the chart.
The Legend component automatically generates a list of all data series (e.g., '2023 Sales', 'Projected Costs') or categories (e.g., 'North America', 'EMEA') present on the chart, associating each one with its corresponding color, line style, or pattern. Crucially, the Designer allows you to configure the Legend not just for display (position, font, orientation) but also for interactivity. This means users can often click or tap on a legend item to dynamically toggle the visibility of that specific series or category on the chart. This interactivity is a powerful feature, enabling users to isolate key trends, declutter complex visualizations, and focus their analysis without needing to leave the dashboard.
Prerequisites:
A chart component on the canvas
A data connection is created and associated with the chart
Steps
Click the Component Library icon (right edge).
Select and drag a chart component onto the canvas.
Create a data connection.
Associate the data connection with the chart.
From the Component Library’s Other tab, drag the Legend component onto the canvas.
Open the Legend component properties → General.
Click Associate Chart and choose the required chart.
The Associated Chart wizard opens.
In the Search available components, select the dragged chart.
In the Search available fields, use the checkmarks to select the fields to associate.
Click Save.
Troubleshooting
Legend shows no items: Reopen Associated Chart, confirm the chart and fields are selected, and that the chart’s dataset is loaded.
Wrong labels/colors: Check the chart’s Dataset Properties (Display Name/Color) and re-save; the legend reflects those settings.
Legend not controlling chart: Some charts support legend interactivity; if not, the legend will be displayed only.