info.md

Search Card

A Lovelace card that enables quick entity searching with customizable actions.

Features

• 🔍 Quick entity search within the Home Assistant frontend
• ⚡ Custom actions with regex-based matching
• 🎯 Domain filtering (include/exclude specific domains)
• 📋 Configurable result limits and placeholder text

Prerequisites

• Home Assistant
• card-tools

Using the card

Options

Name	Type	Default	Description
max_results	integer	10	Maximum number of search results to display
search_text	string	"Type to search..."	Custom placeholder text
actions	object	optional	Custom action definitions
included_domains	string[]	optional	Only show entities from these domains*
excluded_domains	string[]	optional	Hide entities from these domains*

*Note: included_domains and excluded_domains cannot be used together

Example Configuration

type: custom:search-card
max_results: 10
search_text: "Search entities..."
excluded_domains:
  - automation
  - script

Domain Filtering Example

Include only lights and switches:

type: custom:search-card
included_domains:
  - light
  - switch

Custom Actions Example

type: custom:search-card
actions:
  - matches: '^toggle (.+\..+)'
    name: "Toggle {1}"
    service: homeassistant.toggle
    service_data:
      entity_id: { 1 }

Issues and Troubleshooting

If you encounter issues:

1. Clear browser cache
2. Restart Home Assistant
3. Verify card-tools is properly installed
4. Check your configuration syntax

If you believe you have found an error, please create an issue with:

• Your configuration
• Home Assistant version
• Browser and version
• Error messages (if any)

Roadmap

Planned features:

• Entity exclusion list
• "Show all" results button
• Additional action types
• More polished UI