Home Assistant Utility Meter Integration: A 2026 Deep Dive

Last updated on February 7, 2026

Integrating your utility’s official data into Home Assistant is a game-changer for anyone looking to truly understand and optimize their power consumption. Forget waiting for a surprise monthly bill; getting hourly data directly on your dashboard empowers you to make smarter decisions, build powerful automations, and ultimately, save serious money. While the US doesn’t have a single, unified platform for this, Spain’s Datadis system provides a fantastic blueprint of what’s possible. In this 2026 guide, we’ll use it as a case study to walk you through the entire process, giving you the most comprehensive look at this powerful feature.

What is Datadis? (And Why You Want This for Your Home Assistant)

Datadis is a neutral, free platform backed by Spain’s major electric distribution companies. Its goal is simple: give consumers direct access to the data their smart meter records. While specific to Spain, the concept is universal. Integrating a similar data source into Home Assistant unlocks massive potential:

Centralized Monitoring: See your daily, monthly, and annual electricity usage right alongside all your other smart home sensors.
Granular Data: Get hour-by-hour breakdowns of your consumption, perfect for pinpointing which appliances are energy hogs and when.
The Foundation for Automation: Got solar panels or a time-of-use rate plan? You can create automations to run the dishwasher, water heater, or charge your EV during the absolute cheapest hours.
Completely Free: Accessing your own utility data through official platforms like this costs nothing.

Installation Guide: A Look at the Datadis Integration (2026 Method)

The old days of messing with YAML configuration files for this are long gone. Thankfully, the modern process for integrations like this is much easier and handled entirely through the Home Assistant UI. Let’s walk through it!

Prerequisites

An updated Home Assistant instance: Keeping your system up-to-date is crucial for compatibility.
HACS installed and running: HACS (Home Assistant Community Store) is the easiest way to install custom components.
An account with your utility provider’s data portal: For this example, it’s the official Datadis website where you add your supply contract.
Your supply point identifier: In Spain, this is the CUPS code (Código Unificado de Punto de Suministro). You’ll find this on your bill or in your utility profile. Think of it as your unique account or meter number.

Step 1: Install the Integration from HACS

The official, actively maintained integration is installed via HACS. The old uvejota/homeassistant-edata repository is archived and should no longer be used.

In Home Assistant, navigate to HACS > Integrations.
Click the blue “Explore & Download Repositories” button.
In the search bar, type “Datadis” and select it (the author is gisce).
Click “Download” in the bottom-right corner and confirm the download.

Step 2: Restart Home Assistant

Once HACS finishes the installation, Home Assistant needs a restart to load the new integration. You can do this from Settings > System > Power icon (top right) > Restart Home Assistant.

Step 3: Configure the Integration

With Home Assistant back online, it’s time to add and configure Datadis:

Go to Settings > Devices & Services.
Click the “+ Add Integration” button.
Search for “Datadis” and click on it.
A configuration window will pop up, asking for:
- Username: Your Datadis registration email.
- Password: Your Datadis password.
- CUPS: Your unique supply point code.
Click “Submit.” If the credentials are correct, the integration will be added successfully.

And that’s it! Home Assistant will start pulling in the data. Be patient, as the first sync can take a few minutes. You’ll find a new consumption sensor named sensor.datadis_consumo_xxxx, where xxxx are the last digits of your CUPS.

Visualizing Your Data: Building a Killer Energy Dashboard Card

Having the data is cool, but visualizing it effectively is where the magic happens. Here’s how to create a card for your Dashboard to monitor your consumption.

Example 1: Simple Sensor Card

To quickly see today’s total consumption, you can use a basic “Sensor” card. Add a new card to your dashboard and paste the following code into the YAML editor:

type: sensor
entity: sensor.datadis_consumo_xxxx # <-- Change this to your entity
name: Consumption Today
graph: line

Example 2: Advanced Graph with ApexCharts-Card

For a more powerful visualization, I highly recommend installing the ApexCharts-Card from HACS. Once installed, it lets you create incredibly detailed graphs. Here’s an example to display the last week’s consumption as a bar chart:

type: custom:apexcharts-card
header:
  show: true
  title: Weekly Power Consumption
  show_states: true
  colorize_states: true
series:
  - entity: sensor.datadis_consumo_xxxx # <-- Change this to your entity
    type: column
    name: kWh
    group_by:
      func: max
      duration: 1d
    show:
      datalabels: true
graph_span: 7d
span:
  end: day

Frequently Asked Questions (FAQ) & Troubleshooting

“Authentication error” or “Invalid credentials”

This is the most common hiccup. Double-check your username and password by trying to log in directly to your utility’s data portal. Pro tip: copy and paste the credentials to avoid typos, and make sure there are no leading or trailing spaces.

The sensor doesn’t appear or shows “unavailable”

Utility data platforms can be slow to serve data, especially on the first pull. Give it a solid 30-60 minutes. If the problem persists, check your Home Assistant logs (Settings > System > Logs) for any error messages related to the integration.

My unique identifier (CUPS) is invalid

The identifier code must be identical to the one in your utility profile, including capitalization. Some providers add prefixes or suffixes (like “ES”). You must include them exactly as they appear on your bill.

The data is always a day behind

This is completely normal. Utility companies typically consolidate and publish the previous day’s consumption data overnight. So, it’s standard to see yesterday’s data in Home Assistant today. This isn’t a bug in the integration; it’s just how these official data platforms work.

You might also be interested in: If you’re looking for real-time measurements, I recommend a clamp-on energy monitor like the Shelly EM. It’s the perfect complement to the historical data from your utility provider.