Advanced Configuration

This section covers additional configuration options that go beyond the essential setup. While the basic settings provide everything needed to get the card running, these advanced parameters allow you to deeply customize its behavior and appearance.

Using these settings, you can adjust layout dimensions to perfectly fit your dashboard, configure accessibility options, manage the visibility of specific UI elements and completely override the default map colors.

Full Height (full_height)

Because the map is fully pannable and zoomable, the card is explicitly designed to never render taller than the screen under any circumstances. This ensures the entire map view always fits within the viewport without requiring the page to be scrolled.

If you wish to override this intended design, you can set this parameter to false. When disabled, the card will always scale to fill the maximum available width, even if its resulting height exceeds the screen boundaries.

Not Recommended

Setting this parameter to false is generally not recommended. It can negatively impact the navigation and overall user experience of the dashboard and may cause unnecessary locking of the map's panning functionality unless configured otherwise in the locked configuration parameter.

Aspect Ratio (aspect_ratio)

This defines the aspect ratio of the map display area. For example, a value of 1.5 means the width is 1.5 times the height. It can be set between 0.1 and 100 depending on the shape of the floorplan.

IMPORTANT

Unless full_height is set to true, the card will never be displayed taller than the view, regardless of the aspect ratio provided.

Left Handed Mode (left_handed)

Setting this parameter to true displays the action buttons and their associated menus on the left side of the card instead of the right side, provided the card is wide enough for the content to be aligned to the right.

Disable Haptic Feedback (disable_haptic)

Setting this parameter to true disables the haptic feedback vibrations triggered by the card during UI interactions on mobile devices with haptic capabilities.

IMPORTANT

Haptic feedback for service call success and failure results cannot be disabled. This ensures consistency with standard Home Assistant behavior for interactive components like switches and selectors that trigger service calls.

Touch Lock Duration (touch_lock)

Overrides the default 100 ms touch unlock hold duration used in the auto and only_touch modes detailed in the Card Lock Mode section. It accepts values between 100 and 400 ms.

Legacy Switches (legacy_switches)

Setting this parameter to true reverts the switches back to the old Material toggle design, instead of using the newer toggle design introduced in Home Assistant 2026.5.

WARNING

If the installed version of Home Assistant is older than 2026.5, setting this parameter to true has no effect, as the legacy switch design is already used natively.

Scripts (scripts)

A list of Home Assistant Script entities, such as - script.sweep_living_room, that are added directly to the vacuum's Shortcuts list on the home screen.

The shortcuts list displays these scripts with their entity names alongside a Start () button. They are inserted at the very top of the shortcuts list, maintaining the exact order defined in the configuration. This means custom scripts are displayed before the robot's native shortcuts.

Additionally, if the vacuum device does not natively support shortcuts, defining scripts here forces the shortcut action button to become visible on the home screen. This allows the card to provide similar shortcut functionality via Home Assistant for unsupported devices.

YAML Example

type: custom:dreame-vacuum-card
entity: vacuum.l10s_gen2
aspect_ratio: 1.5
full_height: true
touch_lock: 200
disable_haptic: true
left_handed: true
legacy_switches: true
scripts:
  - script.sweep_living_room
  - script.mop_kitchen