Repository navigation
Feature PIN
tempus2016 edited this page Oct 31, 2026
·
1 revision
Ask for a code before a tab opens: handy for a Settings or Alarm tab on a shared wall panel, so children or guests don't wander in.
tabs:
- name: Security
icon: mdi:shield-lock
pin: "2468"
pin_timeout: 5 # optional: minutes the unlock lasts (default: until the page reloads)
card: { ... }This is a convenience lock, not security. The PIN is part of the dashboard config, which anyone who can edit the dashboard (or read its raw config) can see, and the cards on the tab can still be reached in other ways. To keep people out of controls, use Home Assistant users and permissions.
- Tapping, swiping, the arrows, keyboard shortcuts, Back, and
selectTab()all ask for the code first. A wrong code clears the field and says so; Cancel, Esc or a tap outside closes the prompt. - After the right code, the tab stays unlocked in this browser for
pin_timeoutminutes, or until the page is reloaded. - If the tab that would open first is locked, the deck opens on the first unlocked tab instead.
-
auto_rotateandidle_returnskip locked tabs. Remote control opens them without the code. - While editing the dashboard there's no prompt.
- Style:
--tabdeck-pin-zsets the prompt's stacking order (default10).
Concepts
Features
- All features
- Dynamic tabs
- Remote control & events
- PIN-locked tabs
- Reuse: defaults & templates
- Debug panel
- State-driven icons & names
- Alert pulse
- Auto-rotate & idle return
- Navigation & action tabs
- Scroll-spy
- Collapsible deck
- Responsive layouts
- Style presets
- Tab-change actions
- Tab display mode
- Accent indicator
- Extra bar styles
- Indicator thickness
- Sticky tab bar
- Tab alignment
- Badge display mode
- Per-tab colour
- Tab subtitles
- Disabled tabs
- Multiple cards per tab
- Panel transitions
- Content layout
- Duplicate tab
- Expand/Collapse all
- Edit mode helpers
- Why is this tab hidden?
- Starter templates
- Convert from another card
- Languages
- Dock & floating action tabs
- Dots & content arrows
- Grouped tabs
- Search & shortcuts
- Arrange tabs