Universal Card GitHub Pages Docs
Universal Card Docs

Features

Field Matrix

Quick lookup matrix for major Universal Card fields, editor coverage, and the best documentation entry point.

Field Matrix

This page is the fastest way to answer four practical questions:

  1. what the field group is called
  2. whether the editor supports it well
  3. whether YAML is still the better fit
  4. where the best example lives

How To Read This Page

Column Meaning
Field group The config block or field family
Typical fields The most important keys in that group
Editor Full, Partial, or YAML-first
Best docs The page that explains the group in context
Example The best starting recipe

Shell And Layout

Field group Typical fields Editor Best docs Example
Root shell title, subtitle, icon, icon_color, entity, theme Full Configuration Basic expandable card
Grid grid.columns, gap, row_gap, column_gap, colspan, rowspan Partial Grid Layout Advanced grid with spans
Header layout header.layout.variant, gap, content_gap, align, badges_position Full Header Layout Header layout presets
Footer footer.text, footer.icon, footer.actions[], footer_left, footer_right Partial Footer Footer cards and actions

Body Modes

Field group Typical fields Editor Best docs Example
Expand body_mode: expand, grid.*, animation fields Partial Body Modes Layout Basic expandable card
Modal modal.width, height, max_width, max_height, loading_strategy Full Modal Layout Modal with responsive sizing
Fullscreen fullscreen.width, height, max_width, max_height, padding, background Full Body Modes Layout Fullscreen mode
Tabs tabs[], tabs_config.position, show_icons, show_labels, content_padding, tab_min_width, tab_alignment Full Body Modes Layout Tabs mode
Carousel carousel_autoplay, carousel_interval, carousel_options.show_arrows, show_indicators, loop, swipe_threshold, height Full Body Modes Layout Carousel mode
Subview subview.path, navigation_path, replace_state, return_on_close Full Body Modes Layout Subview mode
None body_mode: none Full Body Modes Layout Header-only card

Badges, Rules, And Actions

Field group Typical fields Editor Best docs Example
Badges type, icon, label, value, unit, icon_only Full Badges Badge rules and icon-only mode
Badge visibility badges[].visibility[] Full Visibility Badge visibility on a separate entity
Badge color rules badges[].color_rules[] Full Badges Badge rules and icon-only mode
Card actions tap_action, hold_action, double_tap_action Partial Actions And Gestures Root actions and context menu
Badge actions badges[].tap_action, badges[].icon_tap_action YAML-first Badges Root actions and context menu
Context menu context_menu.items[] YAML-first Actions And Gestures Root actions and context menu
Swipe swipe.enabled, direction, threshold, velocityThreshold, preventScroll, directional actions Full Actions And Gestures Swipe gestures
Visibility visibility, section_visibility.* Full Visibility Visibility and section visibility

Styling

Field group Typical fields Editor Best docs Example
Theme theme Full Theming Guide Theme-only quick restyle
Icon color icon_color Full Theming Guide Themes, tokens, and state styles
Theme tokens theme_tokens Full Theming Guide Themes, tokens, and state styles
State styles state_styles Full Theming Guide Themes, tokens, and state styles
Custom CSS custom_css YAML-first Custom CSS Recipes Custom CSS accent
CSS hooks data-uc-* hooks and stable selectors YAML-first Selector Catalog Custom CSS Recipes

Runtime And Editor

Field group Typical fields Editor Best docs Example
Inline lazy loading lazy_load, lazy_initial_batch, lazy_batch_size, lazy_idle_timeout, skeleton_count YAML-first Loading Strategy Loading strategy and stable wall panel setup
Stability and pooling stability_mode, remember_expanded_state, remember_mode_state, enable_card_pool, pool_scope, pool_ttl_ms, pool_max_entries YAML-first Loading Strategy Loading strategy and stable wall panel setup
Visual editor section-based config editing N/A Editor Editor-driven setup

Practical Reading Order

  1. Configuration
  2. Examples Gallery
  3. This page for fast lookup
  4. The focused guide for the area you are tuning