The Input number integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to define values that can be controlled via the frontend and can be used within conditions of automation. The frontend can display a slider, or a numeric input box. Changes to the slider or numeric input box generate state events. These state events can be utilized as automation triggers as well.
The preferred way to configure an input number is via the user interface at Settings > Devices & services > Helpers. Click the add button and then choose the Number option.
To be able to add Helpers via the user interface you should have default_config: in your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more], it should already be there by default unless you removed it.
If you removed default_config: from you configuration, you must add input_number: to your configuration.yaml first, then you can use the UI.
Input numbers can also be configured via configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more]:
# Example configuration.yaml entry
input_number:
slider1:
name: Slider
initial: 30
min: -20
max: 35
step: 1
box1:
name: Numeric Input Box
initial: 30
min: -20
max: 35
step: 1
mode: box
Configuration Variables
Alias for the input. Multiple entries are allowed.
Minimum value.
Maximum value.
Friendly name of the input.
Initial value when Home Assistant starts.
Step value. Smallest value 0.001.
Can specify box or slider.
Unit of measurement in which the value of the slider is expressed in.
Icon to display in front of the input element in the frontend.
List of actions
The Input number integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.
-
Decrement input number (
input_number.decrement) Decrements the value of an input number by 1 step. -
Increment input number (
input_number.increment) Increments the value of an input number by 1 step. -
Reload input numbers (
input_number.reload) Reloads the input number helpers from the YAML configuration. -
Set input number value (
input_number.set_value) Sets the value of an input number.
For an overview of every action across all integrations, see the actions reference.
Restore state
If you set a valid value for initial this integration will start with the state set to that value. Otherwise, it will restore the state it had before Home Assistant stopping. initial is only available in a YAML configuration and not via the Home Assistant user interface.
Scenes
To set the value of an input_number in a Scene:
# Example configuration.yaml entry
scene:
- name: Example Scene
entities:
input_number.example_number: 13
Automation examples
Here’s an example of input_number being used as a trigger in an automation.
# Example configuration.yaml entry using 'input_number' as a trigger in an automation
input_number:
bedroom_brightness:
name: Brightness
initial: 254
min: 0
max: 254
step: 1
automation:
- alias: "BedroomLight-AdjustBrightness"
triggers:
- trigger: state
entity_id: input_number.bedroom_brightness
actions:
- action: light.turn_on
target:
entity_id: light.bedroom
data:
brightness: "{{trigger.to_state.state|int}}"
Another code example using input_number, this time being used in an action in an automation.
# Example configuration.yaml entry using 'input_number' in an action in an automation
input_select:
scene_bedroom:
name: Scene
options:
- Select
- Concentrate
- Energize
- Reading
- Relax
- 'OFF'
initial: "Select"
input_number:
bedroom_brightness:
name: Brightness
initial: 254
min: 0
max: 254
step: 1
automation:
- alias: "BedroomLight-Custom"
triggers:
- trigger: state
entity_id: input_select.scene_bedroom
to: "CUSTOM"
actions:
- action: light.turn_on
target:
entity_id: light.bedroom
data:
brightness: "{{states('input_number.bedroom_brightness')|int}}"
Example of input_number being used in a bidirectional manner, both being set by and controlled by an MQTT action in an automation.
# Example configuration.yaml entry using 'input_number' in an action in an automation
input_number:
target_temp:
name: Target Heater Temperature Slider
min: 1
max: 30
step: 1
unit_of_measurement: step
icon: mdi:target
# This automation script runs when a value is received via MQTT on retained topic: setTemperature
# It sets the value slider on the GUI. This slides also had its own automation when the value is changed.
automation:
- alias: "Settempslider"
triggers:
- trigger: mqtt
topic: "setTemperature"
actions:
- action: input_number.set_value
target:
entity_id: input_number.target_temp
data:
value: "{{trigger.payload}}"
# This second automation script runs when the target temperature slider is moved.
# It publishes its value to the same MQTT topic it is also subscribed to.
- alias: "Tempslidermoved"
triggers:
- trigger: state
entity_id: input_number.target_temp
actions:
- action: mqtt.publish
data:
topic: "setTemperature"
retain: true
payload: "{{states('input_number.target_temp')|int}}"
Here’s an example of input_number being used as a delay in an automation.
# Example configuration.yaml entry using 'input_number' as a delay in an automation
input_number:
minutes:
name: minutes
icon: mdi:clock-start
initial: 3
min: 0
max: 6
step: 1
seconds:
name: seconds
icon: mdi:clock-start
initial: 30
min: 0
max: 59
step: 10
automation:
- alias: "turnsomethingoffafterxtimeafterturningiton"
triggers:
- trigger: state
entity_id: switch.something
to: "on"
actions:
- delay: "00:{{states('input_number.minutes')|int}}:{{states('input_number.seconds')|int}}"
- action: switch.turn_off
target:
entity_id: switch.something