Configuration

The Fast Search Card offers a wide range of configuration options, from a simple automatic setup to complex custom data sources.

Basic Example

This is the simplest configuration. The card will automatically find all supported devices.

type: custom:fast-search-card
title: Smart Home Search
auto_discover: true

Main Options

Option	Type	Description	Default
type	String	Required. Must be custom:fast-search-card.	-
title	String	The title displayed as a placeholder in the search bar.	Fast Search
default_view	String	The default view when opened. grid or list.	grid
auto_discover	Boolean	If true, entities will be discovered automatically.	false
entities	Array	A manual list of entities to be displayed.	[]
custom_mode	Object	Configuration for the custom mode (see below).	{}

---

Auto-Discovery Options

When auto_discover: true is set, you can refine the discovery with these filters:

Option	Type	Description
include_domains	Array	A list of domains that should be exclusively included (e.g., ['light', 'switch']).
exclude_domains	Array	A list of domains to be ignored.
include_areas	Array	A list of areas that should be exclusively included.
exclude_areas	Array	A list of areas to be ignored.
exclude_entities	Array	A specific list of entity IDs to be ignored.

Example:

type: custom:fast-search-card
auto_discover: true
exclude_domains:
  - weather
  - sensor
exclude_entities:
  - light.decoration_light

---

Custom Mode

The Custom Mode is a powerful feature for displaying your own data sources.

type: custom:fast-search-card
custom_mode:
  enabled: true
  category_name: 'Recipes' # Name for the custom button
  icon: '🍳'
  data_sources:
    # ... your data sources go here ...

Data Source: static

Define a static list directly in the configuration.

# ... inside data_sources ...
- type: static
  items:
    - id: carbonara
      name: 'Spaghetti Carbonara'
      area: 'Italian Cuisine'
      custom_data:
        metadata:
          difficulty: 'Medium'
          time: '25 min'
          category: 'Main Course'
        content: |
          ## Ingredients
          - 200g Spaghetti
          - 100g Pancetta
          ...

Data Source: template_sensor

Read a JSON-formatted list from the attribute of a template sensor.

# ... inside data_sources ...
- type: template_sensor
  entity: sensor.my_recipes_json
  content_attribute: 'items' # Name of the attribute with the JSON list

Data Source: mqtt

Read a JSON-formatted list from an MQTT sensor. Content can be edited directly in the card and saved back via MQTT.

# ... inside data_sources ...
- type: mqtt
  entity: sensor.mqtt_notes
  content_attribute: 'items'