2025.10.3
Home ▸ Integrations ▸

Droplet

The Droplet integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] seamlessly connects your Home Assistant setup to Droplet – an advanced all-in-one smart home water sensor.

Leveraging cutting-edge ultrasonic sensing technology, Droplet accurately monitors your home’s water usage in real time. It safeguards your property from potential water damage and empowers you to make informed decisions about water conservation and identify anomalies early.

Stay in control of your home’s water system efficiently and intelligently with Droplet and Home Assistant.

Prerequisites

Before connecting to Home Assistant, it is necessary to enable the integration on your Droplet.

In the Droplet app, navigate to Settings > Smart Home Integrations > Home Assistant. Enable the integration and copy the token that appears on the screen. You will need to enter this in the configuration step.

Configuration

To add the Droplet integration to your Home Assistant instance, use this My button:

Droplet can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

IP address

If your Droplet has a fixed IP address, you can use it for manual configuration. This field is not required for auto discovery.

Pairing code

Pairing code to authenticate with Droplet device. You can find it on the Droplet app under Settings > Smart Home Integrations > Home Assistant.

Supported functionality

Sensors

The following sensors values are available:

  • Flow rate
  • Volume
  • Server connectivity
  • Signal quality

Data updates

Once the integration connects, Droplet will push data points as soon as they are available. During periods of increased activity, this may be as often as every 5 seconds. During periods of inactivity, it may be as seldom as every 30 seconds.

Use cases

Adding Droplet to your Energy Dashboard

  1. Open the edit menu of your energy dashboard.
  2. Select the water consumption tile. Screenshot of water consumption tile
  3. Select one of Droplet’s volume sensors. Optionally, track your costs. Screenshot of water consumption source picker
  4. Water usage recorded by Droplet will now be incorporated into your energy dashboard. Screenshot of a water sensor on the energy dashboard

Removing the integration

This integration follows standard integration removal process.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.

  2. From the list of devices, select the integration instance you want to remove.

  3. Next to the entry, select the three dots menu. Then, select Delete.

  4. To prevent Droplet from showing up as a discovered device after its removal, disable the local API in the Droplet app under Settings > Smart Home Integrations > Home Assistant.

FAQ & Troubleshooting

Q: Why does Droplet’s volume sensor sometimes show negative values?

A: The volume reported by Droplet over local API is point-to-point, meaning that each new value represents the difference in volume recorded since this data was last sent. Even when you’re not using appliances in your home, there can still be activity in your pipes. Droplet tries to be very accurate and is sensitive to small flows, which can include water sloshing back and forth, or slight movement as a result of pressure differences. Small negative values are to be expected, and are reported so that cumulative statistics reported in Home Assistant (or other consumers of the API) can be fully accurate.

Q: Why is my Droplet failing to authenticate with Home Assistant?

A: If your Droplet is failing to authenticate, try waiting 1-2 minutes after enabling Home Assistant or regenerating the code in the Droplet app. It may take a moment for the Droplet to be ready to accept connections.