Local input number¶

A local input number is a local numeric value that can be used by the card like an entity state. It is useful for settings such as a history duration, threshold, scale limit, size, or offset when Home Assistant does not need to own that value.

A local input number is not created in Home Assistant. Its entity ID must start with fhs_input_number., which tells the card to create and manage the value locally.

This page shows how to define its range and step, change it with controls or actions, use the number elsewhere in the card, and optionally persist it on this Home Assistant client.

Add a number¶

Use a local input number when the card needs a local numeric value. Add min and/or max only when the value needs limits; without them the value is unbounded in that direction.

1
2
3
4
5
6
7
8

entities:
  - entity: fhs_input_number.history_days  # Create or use this local input
    initial: 1  # Value used when this local input is created
    min: 1
    max: 14
    step: 1  # Amount added or removed by each adjustment
    unit: d  # Unit shown with the value
    scope: card  # Keep this value inside this card

Change it with a Number control or Slider¶

Connect a Number control for minus/plus steps or a Slider for direct dragging.

Use the value in the card¶

Read the state in a JavaScript template and convert it to a number when needed:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

entities:
  - entity: fhs_input_number.history_days  # Local number used to choose the history length
    initial: 1
    min: 1
    max: 14
  - entity: sensor.temperature  # Entity whose history is graphed

layout:
  sparklines:
    - entity_index: 1  # Graph the temperature entity
      xpos: 50
      ypos: 50
      width: 80
      height: 35
      # Convert the selected number of days to hours for the Sparkline.
      period:
        rolling_window:
          duration:
            hour: |
              [[[
                return Number(entities[0].state) * 24;
              ]]]

Change the value from an action¶

Actions can update the local number when the value should change from another control instead of a Number or Slider control.

The result stays within min and max.

Share or persist the value¶

Use scope: global to share the number with cards in this Home Assistant client. Add persist: true to restore the global value after a reload.

Configuration options¶

Required applies to the specific form described by that table: Yes means you need the field for that form; No means you can leave it out. Not set means the card adds no explicit value when the option is omitted.

Related¶

• Number control
• Slider
• Local input entities
• JavaScript templates