Chord

The Chord Chart is a specialized diagram used to display the inter-relationships between data categories.
Categories are arranged around a circle, with curved lines or ribbons connecting them to visualize the strength and flow of relationships between paired dimensions.

Use cases:

• Visualizing relationships or flows between categories.
• Showing network structures or cross-dimensional connections.
• Comparing interdependent quantities across multiple categories.

Note

Use Chord Charts when the goal is to reveal connections and flows within a network of categories.
Avoid for simple categorical comparisons or when too many connections could cause visual clutter.

---

⚙️ Setup

1. Drag the Chord Chart widget from the chart library onto your designer workspace.
2. Select the chart.
3. Go to the Widget Configuration tab in the Configuration panel.
4. Under the Configuration panel tab, select the Basic Configuration option to access essential settings for the Chord Chart.
5. Select the Source from which the chart will fetch its data.
6. Map:
   • Measure — Numeric value representing the relationship magnitude.
   • Dimension — Multiple categorical values (minimum 2) representing the categories around the circle.
7. Optionally add a Date field for time-based filtering.

---

📊 Basic Configuration

Configuration Item	Description
Source	The data source to query for chart values.
Measure	Numeric value representing the size of connections between categories.
Dimension	At least two categorical dimensions used to create the relationships and groupings around the circle.
Date Field (optional)	Enables date-based filtering and drilldown capability.

Note

Use multiple Dimensions (minimum 2, ideally 3-5) to create meaningful and visually interpretable connections.

---

🎨 Chart Customizations

Category	Options & Description
General	Theme, background, border, and interactivity options.
Title	Chart title, font, alignment, and visibility settings.
Sorting	Define custom sorting for dimensions and connection order.
Position	Adjust horizontal and vertical positioning of the chord within the chart.
Legend	Show/hide, position, and format for category legends.
Series	Customize node sizes, connection curviness, colors, labels, and positioning of the connections.
Tooltip	Tooltip content, format, and triggers for node and connection hover details.
Others	Configure symbol sizes, line curviness, connection colors (by Source or Target), and layout orientation.

Note

Use Symbol Minimum/Maximum Size to control the proportional size of category nodes. Adjust Line Curveness to visually declutter overlapping connections.

---

📊 Example Visualization