Custom Text Sensor


Custom components are deprecated, not recommended for new configurations and will be removed from ESPHome in a future release. Please look at creating a real ESPHome component and “importing” it into your configuration with External Components.

You can find some basic documentation on creating your own components at Contributing to ESPHome.


While we try to keep the ESPHome YAML configuration options as stable as possible, the ESPHome API is less stable. If something in the APIs needs to be changed in order for something else to work, we will do so.

This component can be used to create custom text sensors in ESPHome using the C++ (Arduino) API.

Please first read Custom Sensor Component guide, the same principles apply here and text sensors are very similar to sensors internally.

The example below is an example of a custom text sensor which constantly publishes the message “Hello World!”.

#include "esphome.h"

class MyCustomTextSensor : public PollingComponent, public TextSensor {
  // constructor
  MyCustomTextSensor() : PollingComponent(15000) {}

  void setup() override {
    // This will be called by App.setup()
  void update() override {
    // This will be called every "update_interval" milliseconds.
    // Publish state
    publish_state("Hello World!");

(Store this file in your configuration directory, for example my_text_sensor.h)

And in YAML:

# Example configuration entry
    - my_text_sensor.h

- platform: custom
  lambda: |-
    auto my_custom_sensor = new MyCustomTextSensor();
    return {my_custom_sensor};

    name: "My Custom Text Sensor"

Configuration variables:

  • lambda (Required, lambda): The lambda to run for instantiating the text sensor(s).

  • text_sensors (Required, list): A list of text sensors to initialize. The length here must equal the number of items in the return statement of the lambda.

See Also