Behaviour
Behaviour settings control how the dashboard feels when people use it. They decide how saving works, how editing is protected, whether Home Assistant chrome is hidden, how mobile behavior is handled, and whether debug tools are enabled.
Saving and editing
Auto-save makes editing feel smoother because changes are stored as you work. For large dashboards, the debounce value helps avoid saving too aggressively while cards are being dragged or resized.
If the dashboard is used on a wall tablet or by other people, an edit PIN can prevent accidental changes. It is meant as practical protection, not as a full security system.
Kiosk-style dashboards
For wall panels, hiding the Home Assistant header and sidebar can make the dashboard feel like a dedicated app. This works especially well together with a screen saver and clear touch-friendly controls.
Settings reference
| Dashboard setting | YAML setting | What it does | Value possibilities |
|---|---|---|---|
| Auto-save | auto_save | Automatically saves changes while editing. | true or false. |
| Auto-save delay | auto_save_debounce | Controls how long DDC waits before saving repeated edits. | Delay in milliseconds. |
| Edit mode PIN | edit_mode_pin | Protects edit mode from accidental access. | Empty value or PIN text. |
| Hide Home Assistant header | hide_HA_Header | Hides the top Home Assistant header for kiosk-style dashboards. | true or false. |
| Hide Home Assistant sidebar | hide_HA_Sidebar | Hides the Home Assistant sidebar for a cleaner wall-panel view. | true or false. |
| Do not resize text | do_not_resize_text | Prevents automatic text resizing when layouts change. | true or false. |
| Debug mode | debug | Enables extra diagnostics for troubleshooting. | true or false. |