Troubleshooting
Most Drag & Drop Card issues are caused by missing resources, stale browser cache, missing custom card dependencies, reused storage keys, or imported entities that do not exist in your Home Assistant instance.
Common checks
| Problem | What to check |
|---|---|
| Card does not load | Check the Lovelace resource, clear browser cache, and confirm the JavaScript file path. |
| Layout does not save | Check storage_key, backend availability, and browser storage. |
| Imported dashboard looks broken | Install missing custom cards and replace missing entity IDs. |
| Tabs do not show expected cards | Check each card's tab assignment. |
| Layers hide cards unexpectedly | Check whether the card is assigned to a layer that is inactive. |
| Connectors do not animate | Check entity, active states, animation mode, and whether the connector is on the current tab. |
| Screen saver does not start | Check whether screen saver is enabled and whether the activation delay is too long. |
| Package helpers do not appear | Run package sync diagnostics and reload Home Assistant. |
Safe recovery flow
- Export the current dashboard before changing anything.
- Check the browser console for errors.
- Confirm that all required custom cards are installed.
- Confirm that imported entity IDs exist in your Home Assistant instance.
- Temporarily disable advanced visuals, connectors, or packages if you are isolating a problem.
- Test with a new storage key if you suspect layout storage is the issue.
When asking for help
Include your Drag & Drop Card version, Home Assistant version, browser, relevant settings, screenshots, and browser console errors. If it is an import or HADS problem, include the design type, dependencies, and whether you tested it in a clean view.
Image slotAdd screenshots of common console errors and where to find diagnostics.
Last updated 2026-05-27.