Features

Features

Every Tabdeck feature is opt-in / configurable — turn things on or off to taste. This page indexes the optional features and links to a dedicated page for each.

This list grows over time. Each feature below has its own page with a description, config key, examples, and screenshots.

Tab bar appearance

• Tab display mode — show icons, labels, or both (tab_display).
• Responsive layouts — side-by-side split view on wide cards; tab_display_narrow on narrow ones.
• Accent-coloured indicator — indicator adopts the selected tab's accent (accent_indicator).
• Extra bar styles — boxed, text, rail styles + indicator_radius.
• Indicator thickness — set the underline bar thickness (indicator_size).
• Sticky tab bar — keep the bar pinned while content scrolls (sticky).
• Tab alignment — start / center / end / justify the tabs (align).
• Bar background & elevation — custom bar colour + shadow (bar_background, elevation).
• Scroll buttons & overflow menu — arrows (scroll_buttons) or a ⋯ jump-to-tab menu (overflow_menu).

Per-tab content

• State-driven icons, names & colours — icon/name/subtitle/color/accent as live Jinja templates.
• Per-tab text/icon colour — fixed label/icon colour for a tab (color).
• Badge display mode — text or dot badges (badge_display).
• Numeric badge formatting — precision, unit and 99+ caps (badge_format).
• Hide inactive badges — hide 0/off badges (hide_inactive_badge).
• Per-tab badge colour — colour a tab's badge (badge_color).
• Multiple cards per tab — stack several cards in one tab (cards).
• Nested decks — a tab's card can be another Tabdeck card (sub-tabs).
• Disabled tabs — show a tab greyed-out and non-selectable (disabled).
• Tab subtitles — secondary text under a tab label (subtitle).
• Content header — show the active tab's title above the content (header); icon-rail recipe.

Navigation & interaction

• Collapsible deck — tap the active tab to fold the content away (collapsible, start_collapsed).
• Scroll-spy (anchor mode) — stack every tab as a section; the bar scrolls to and tracks sections (scroll_spy).
• Panel transitions — fade or slide when switching tabs (transition).
• Navigation & action tabs — a tab that navigates / runs an action instead of opening a panel (tap_action).
• Tab-change actions — run an action when a tab opens or closes (enter_action, leave_action).
• Tab & badge actions — long-press tab (hold_action) and clickable badge (badge_action).
• Auto-rotate & idle return — cycle tabs on a timer (auto_rotate) or return to the default when idle (idle_return).
• Performance & swipe options — unmount_hidden, swipe_wrap, swipe_mouse (desktop drag).

Dynamic behaviour

• Dynamic tabs — generate a tab per item from a live Jinja list (auto_tabs).
• A tab per area / label — auto_tabs: { source: areas }, no Jinja needed.
• Visibility and/or/not groups — nestable logical conditions for tab visibility.
• Alert pulse — a tab pulses while its conditions are met (alert).
• Auto-select a tab — switch tab when an entity becomes active (auto_select).
• Time & user visibility — show tabs by time-of-day/weekday or HA user.
• Conditional default tab — pick the starting tab by state (default_if).

Editor

• Copy & import tabs — copy a tab to the clipboard and import tabs into another deck.
• Duplicate tab — one-click deep copy of a tab in the editor.
• Expand all / Collapse all — bulk-toggle tab blocks; new tabs auto-expand.
• Drag-to-reorder & warnings — drag tabs to reorder; duplicate-name warnings.
• Condition builders — edit Visibility / Alert / Default-when conditions with HA's native builder.
• Live preview — the editor previews the bar as you edit.

Theming

• Style presets — one-line looks: ios, material, glass, minimal, rail (preset).
• Theming & styles passthrough — set CSS variables from config (styles).
• Per-tab styles — styles on a tab, applied while it's active.

---

See Configuration for the complete option reference.

Persistence

• Remember across devices — store the active tab in an entity (remember: entity).
• Custom storage key — independent browser persistence (storage_key).