> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Circular Sankey Chart

## Intro

The Sankey chart—often called a flow diagram—is a great way to illustrate flows, including flows of energy, materials, and web page paths. In addition to the flow of an item, the Sankey chart captures the relative size of the flow itself by changing the line width from node to node. For more information, see our [Sankey Chart](https://domo-support.domo.com/s/article/360043429273?language=en_US) article.

Sankey charts consist of nodes, or end points, and colored arrows or lines. See below for a simple Sankey chart.

<Frame>
  <img alt="image.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/GXvfa618wDUsB9JU/images/kb/ka05w00000127d6-00N5w00000Ri7BU-0EM5w000006u8bV.jpg?fit=max&auto=format&n=GXvfa618wDUsB9JU&q=85&s=4268cf24fe707dc2f7b151945938417a" width="975" height="477" data-path="images/kb/ka05w00000127d6-00N5w00000Ri7BU-0EM5w000006u8bV.jpg" />
</Frame>

The original Sankey chart is ideal for physical flows that go to a destination once per flow, like energy and materials. However, it's not ideal for recursive concepts like web traffic, where flows need to circle back to previous nodes and require special treatment to display properly. To meet these needs, Domo has created the circular Sankey chart.

The following image emphasizes the chart's circular reference:

<Frame>
  <img alt="Circular Sankey Chart.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/GXvfa618wDUsB9JU/images/kb/ka05w00000127d6-00N5w00000Ri7BU-0EM5w000006uAbr.jpg?fit=max&auto=format&n=GXvfa618wDUsB9JU&q=85&s=ea34433192f261a6bb8b12070514ae99" width="2488" height="1088" data-path="images/kb/ka05w00000127d6-00N5w00000Ri7BU-0EM5w000006uAbr.jpg" />
</Frame>

## Powering Circular Sankey Charts

A circular Sankey chart requires each of the following:

* **A `From` dimension** — The source of the flow.
* **A `To` dimension** — The destination of the flow.
* **A value** — The size of the flow.

For information about value, category, and series data, see our [Understanding Chart Data](https://domo-support.domo.com/s/article/360043428693?language=en_US) article.

In Analyzer, you can choose the columns containing the data for your circular Sankey chart. For more information about choosing data columns, see our article about [Applying DataSet Columns to Your Chart](https://domo-support.domo.com/s/article/360043428713?language=en_US).

The following image shows how data from a typical column-based spreadsheet is converted into a circular Sankey chart:

<Frame>
  <img alt="image.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/GXvfa618wDUsB9JU/images/kb/ka05w00000127d6-00N5w00000Ri7BU-0EM5w000006u8e0.jpg?fit=max&auto=format&n=GXvfa618wDUsB9JU&q=85&s=0931b4c3c805ca673c83580a4eabfdfe" width="975" height="483" data-path="images/kb/ka05w00000127d6-00N5w00000Ri7BU-0EM5w000006u8e0.jpg" />
</Frame>

## Customizing Circular Sankey Charts

You can customize the appearance of a circular Sankey chart in several ways, many of which are possible with the **Chart Properties** tool. For more information, see our [Chart Properties](https://domo-support.domo.com/s/article/360042925374?language=en_US) article.

<Warning>
  **Important:** Circular Sankey charts have a 500-row limit.
</Warning>

Some unique properties of circular Sankey charts are shown in the following table:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:209;a"><thead><tr><th colspan="1" rowspan="1"><p> Property </p></th><th colspan="1" rowspan="1"><p> Description </p></th><th colspan="1" rowspan="1"><p> Example </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> General > Value Format </p></td><td colspan="1" rowspan="1"><p> Determines whether currency symbols are appended to values. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> General > Value Decimal Places </p></td><td colspan="1" rowspan="1"><p> Determines the number of decimal places in values. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> General > Percent Value Decimal Places </p></td><td colspan="1" rowspan="1"><p> Determines the number of decimal places in percent values. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> General > Layout method </p></td><td colspan="1" rowspan="1"><p> Allows you to select different layouts for your Sankey data. You can see which one works best for your data. </p></td><td colspan="1" rowspan="1"><p><img alt="image.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/GXvfa618wDUsB9JU/images/kb/ka05w00000127d6-00N5w00000Ri7BU-0EM5w000006u8ej.jpg?fit=max&auto=format&n=GXvfa618wDUsB9JU&q=85&s=a4051e83d5b2b3951afda59c05e7dcb2" width="581" height="225" data-path="images/kb/ka05w00000127d6-00N5w00000Ri7BU-0EM5w000006u8ej.jpg" /></p></td></tr><tr><td colspan="1" rowspan="1"><p> General > Hide Circular </p></td><td colspan="1" rowspan="1"><p> Allows you to hide circular references in the chart. </p><p> When you select this checkbox, the chart handles recursion but doesn't display the loops back. </p></td><td colspan="1" rowspan="1"><p><img alt="image.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/GXvfa618wDUsB9JU/images/kb/ka05w00000127d6-00N5w00000Ri7BU-0EM5w000006u8eo.jpg?fit=max&auto=format&n=GXvfa618wDUsB9JU&q=85&s=f52915185041fb64bcfd5693e11200ba" width="640" height="156" data-path="images/kb/ka05w00000127d6-00N5w00000Ri7BU-0EM5w000006u8eo.jpg" /></p></td></tr><tr><td colspan="1" rowspan="1"><p> Node Options </p></td><td colspan="1" rowspan="1"><p> Allows you to set the fill and border colors for nodes. </p></td><td colspan="1" rowspan="1"><p><img alt="image.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/GXvfa618wDUsB9JU/images/kb/ka05w00000127d6-00N5w00000Ri7BU-0EM5w000006u8eQ.jpg?fit=max&auto=format&n=GXvfa618wDUsB9JU&q=85&s=2906a4ac0466cee914530ebe7356b85e" width="568" height="280" data-path="images/kb/ka05w00000127d6-00N5w00000Ri7BU-0EM5w000006u8eQ.jpg" /></p></td></tr><tr><td colspan="1" rowspan="1"><p> Flow Options </p></td><td colspan="1" rowspan="1"><p> Allows you to set the fill and border colors for flows. </p></td><td colspan="1" rowspan="1"><p><img alt="image.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/GXvfa618wDUsB9JU/images/kb/ka05w00000127d6-00N5w00000Ri7BU-0EM5w000006u8ey.jpg?fit=max&auto=format&n=GXvfa618wDUsB9JU&q=85&s=06f1c0b647e2891bb7af74151338ac80" width="580" height="286" data-path="images/kb/ka05w00000127d6-00N5w00000Ri7BU-0EM5w000006u8ey.jpg" /></p></td></tr></tbody></table>
