# ASP.NET Core CircularGauge Overview

The Telerik UI CircularGauge TagHelper and HtmlHelper for ASP.NET Core are server-side wrappers for the Kendo UI CircularGauge widget.

The CircularGauge represents a value on a circular scale. It allows you to visualize numeric values in an attractive manner that matches the other widgets on the page.

* [Demo page for the CircularGauge HtmlHelper](https://demos.telerik.com/aspnet-core/circular-gauge/index)

* [Demo page for the CircularGauge TagHelper](https://demos.telerik.com/aspnet-core/circular-gauge/tag-helper)

It is essentially very similar to the ArcGauge with the difference that the CircularGauge is a complete circle. There are bigger differences with RadialGauge, however, since the Radial widget is focusing on displaying a value on a scale with the help of a pointer element. Also, setting range colors on the RadialGauge happens for the scale itself, while the color ranges for the CircularGauge happen for the value fill.

## Initializing the CircularGauge

1. Create a new action method which renders the view.

   ```C#
   public ActionResult Index()
   {
       return View();
   }
   ```

2. Add the CircularGauge.

   ```Razor HtmlHelper
       @(Html.Kendo().CircularGauge()
           .Name("circularGauge") // The name of the CircularGauge is mandatory. It specifies the "id" attribute of the widget.
           .Value(65)
           .Scale(x => x.Min(0).Max(100))
           .CenterTemplate("#:value#%")
       )
   ```

   ```Razor TagHelper
       <kendo-circulargauge name="circulargauge" value="65" center-template="#:value#%">
           <scale min="0" max="100">
           </scale>
       </kendo-circulargauge>
   ```

## Functionality and Features

* [Scale](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/gauges/circulargauge/scale)—You can control how the scale of the Circular Gauge renders the values, pointers and labels.
* [Colors](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/gauges/circulargauge/colors)—The scale of the Circular Gauge can be configured to show different colors for different values.
* [Export](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/gauges/circulargauge/export)—You can export the Circular Gauge as an image, SVG, or a PDF file.

## Next Steps

* [Getting Started with Circular Gauge](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/gauges/circulargauge/getting-started)

* [Basic Usage of the CircularGauge HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/circular-gauge/index)

* [Basic Usage of the CircularGauge TagHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/circular-gauge/tag-helper)

## See Also

* [Using the API of the Circular Gauge for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/circular-gauge/api)
* [Knowledge Base Section](https://www.telerik.com/aspnet-core-ui/documentation/knowledge-base)
