# Chord Diagram

> Chord Diagram visualizes flows, directions and magnitude between a set of categories.

Chord Diagram visualizes **flows, directions and magnitude** between a set of categories.

Each category is displayed as an **arc** around the outside of a circle, and the connections between them are drawn as curved bands, or **​chords**​, inside the circle.

The ​size of each arc​ usually represents the **total volume** associated with that category, while the ​width of each chord​ represents the **strength of connection** between two categories.

Use a Chord Diagram when:
- You want to visualize **many-to-many** relationships
- You need to show **movement or flow** between groups
- The main goal is to highlight **interconnectedness**
- Your data contains **source-target pairs** with values, for example, country-to-country trade or customer movement between subscription plans

:::info Get Template

https://github.com/holistics/custom-chart-library/tree/main/chord_diagram

:::