> ## 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.

# Shape Gauge

### Intro

A Shape Gauge uses any of 45 different images to indicate a current value. By using different images to indicate different ranges, you can convey to users whether the current value is positive, neutral, or negative. The classic example of this kind of gauge in Domo is the [Face Gauge](/s/article/360042924534), which shows a smiling green face for positive range values, a neutral orange face for middling values, and an angry red face for negative values.

<Frame>
  <img alt="triple_face_gauges.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/7il5zODxajeeXiuu/images/kb/ka0Vq000000DiHl-00N5w00000Ri7BU-0EM5w000005vP7V.png?fit=max&auto=format&n=7il5zODxajeeXiuu&q=85&s=f7e05f8032dbeb327381e0f4546b4358" width="614" height="194" data-path="images/kb/ka0Vq000000DiHl-00N5w00000Ri7BU-0EM5w000005vP7V.png" />
</Frame>

In addition to faces, all of the following shapes are available for you to use in shape gauges, and many more.

* Geometric shapes like squares, circles, triangles, pentagons, and octagons
* Thumbs up/down
* Airplanes taking off/landing
* Lightning bolts
* Batteries full/empty

You can customize the color of any shape, and have up to 10 ranges in a Shape Gauge.

<Frame>
  <img alt="shape_gauge_example.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/7il5zODxajeeXiuu/images/kb/ka0Vq000000DiHl-00N5w00000Ri7BU-0EM5w000005vP7W.png?fit=max&auto=format&n=7il5zODxajeeXiuu&q=85&s=4c323e4d05123a692aa38e0362e3a5b1" width="709" height="332" data-path="images/kb/ka0Vq000000DiHl-00N5w00000Ri7BU-0EM5w000005vP7W.png" />
</Frame>

Learn more about [other gauges](/s/article/360042924334) in Domo.

***

* Power a Shape Gauge
* Unique properties — Shape Gauges

***

### Power a Shape Gauge

A Shape Gauge requires only one column or row of data from your DataSet, which should contain value data. The value data is aggregated based on what you select in the **Calculation** menu (which you access by selecting the column name next to "Gauge Values"). For example, if you select **Sum**, the values in the column are summed, and this total value is used for the gauge. If you select **No aggregation**, the first value in the DataSet is used. Learn more about [Understanding Chart Data](/s/article/360043428693 "Understanding Chart Data") and [Applying DataSet Columns to Your Chart](/s/article/360043428713 "Applying DataSet Columns to Your Chart").

The following graphic shows you how the data from the category and value columns in a typical column-based spreadsheet is converted into a Shape Gauge:

<Frame>
  <img alt="shape_gauge_spreadsheet_example.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/7il5zODxajeeXiuu/images/kb/ka0Vq000000DiHl-00N5w00000Ri7BU-0EM5w000005vP7X.png?fit=max&auto=format&n=7il5zODxajeeXiuu&q=85&s=9960ee7e0089b5714e2e588c4f9d186b" style={{width: 699, height: 650}} width="749" height="696" data-path="images/kb/ka0Vq000000DiHl-00N5w00000Ri7BU-0EM5w000005vP7X.png" />
</Frame>

### Unique Properties — Shape Gauge

You can customize the appearance of a Shape Gauge by editing its chart properties in Analyzer.

<Warning>
  **Important:** This list describes the properties that are unique to Shape Gauges. To see descriptions of the properties Shape Gauges share with other gauges, see [Properties for Gauges](https://domo.lightning.force.com/s/article/360042925354).
</Warning>

<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></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p><b> Range 1-10 </b> > <b> Symbol </b></p></td><td colspan="1" rowspan="1"><p> Sets the symbol to display for the selected range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Range 1-10 > Maximum Value </p></td><td colspan="1" rowspan="1"><p> Lets you specify the maximum value for the selected range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Range 1-10 > Color </p></td><td colspan="1" rowspan="1"><p> Lets you specify the color for the selected range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Out of Range > Color </p></td><td colspan="1" rowspan="1"><p> Lets you specify the color used when the current value does not fall within any of the ranges you have configured. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Out of Range > Symbol </p></td><td colspan="1" rowspan="1"><p> Lets you specify the symbol used when the current value does not fall within any of the ranges you have configured. </p></td></tr></tbody></table>