Text Sensor Component

Text sensors are a lot like normal sensors. But where the “normal” sensors only represent sensors that output numbers, this component can represent any text.

Base Text Sensor Configuration

# Example sensor configuration
name: Livingroom Temperature

# Optional variables:
icon: "mdi:water-percent"

Configuration variables:

  • name (Required, string): The name for the sensor.
  • icon (Optional, icon): Manually set the icon to use for the sensor in the frontend.


  • on_value (Optional, Automation): An automation to perform when a new value is published. See on_value.

Text Sensor Automation

You can access the most recent state of the sensor in lambdas using id(sensor_id).value.


This automation will be triggered when a new value is published. In Lambdas you can get the value from the trigger with x.

  - platform: version
    # ...
        - lambda: |-
            ESP_LOGD("main", "The current version is %s", x.c_str());

Configuration variables: See Automation.

lambda calls

From lambdas, you can call several methods on all text sensors to do some advanced stuff (see the full API Reference for more info).

  • publish_state(): Manually cause the sensor to push out a value.

    // Within lambda, push a value of "Hello World"
    id(my_sensor).publish_state("Hello World");
  • .state: Retrieve the current value of the sensor as an std::string object.

    // For example, create a custom log message when a value is received:
    std::string val = id(my_sensor).state;
    ESP_LOGI("main", "Value of my sensor: %s", val.c_str());