Gauge Card


The Gauge card is a basic card that allows visually seeing sensor data.

Screenshot of the Gauge card Screenshot of the Gauge card.

Screenshot of the Gauge card in needle mode Screenshot of the Gauge card in needle mode.

To add the Gauge card to your user interface, click the Lovelace menu (three dots at the top right of the screen) and then Edit Dashboard. Click the “Add Card” button in the bottom right corner and select Gauge from the card picker. All options for this card can be configured via the user interface.

Alternatively, the card can be configured using YAML:

type: gauge
entity: sensor.cpu_usage

Configuration Variables

type string Required

gauge

entity string Required

Entity ID to show.

name string (Optional, default: Entity name)

Name of gauge entity.

unit string (Optional)

Unit of measurement given to data.

Default:

Unit of measurement given by entity

theme string (Optional)

Override the used theme for this card with any loaded theme. For more information about themes, see the frontend documentation.

min integer (Optional, default: 0)

Minimum value for graph.

max integer (Optional, default: 100)

Maximum value for graph.

needle boolean (Optional, default: false)

Show the gauge as a needle gauge.

severity map (Optional)

Allows setting of colors for different numbers.

green integer Required

Value from which to start green color.

yellow integer Required

Value from which to start yellow color.

red integer Required

Value from which to start red color.

Examples

Title and unit of measurement:

type: gauge
name: CPU Usage
unit: '%'
entity: sensor.cpu_usage

Screenshot of the gauge card with custom title and unit of measurement Screenshot of the gauge card with custom title and unit of measurement.

Define the severity map:

type: gauge
name: With Severity
unit: '%'
entity: sensor.cpu_usage
severity:
  green: 0
  yellow: 45
  red: 85