Moving from HKI Parcels Card¶
HKI Parcels Card (v1.7.x) no longer gets updates. HA Parcel Card is its successor: the same card, still maintained, with support for every carrier in the ha-parcel-integrations family.
Both cards can be installed at the same time, because they use different card types. You can set up HA Parcel Card next to your current card, check it, and only then remove the old one.
What carries over¶
- Card options: title, tabs, sorting, grouping, colours, layout order and every
show_*switch keep their name and meaning. - Carrier entries:
user, theentity_*fields and the*_pathfields stay the same. - Custom parcel names: they move over automatically the first time HA Parcel Card loads.
- Required Home Assistant version: 2026.7 or newer, the same as before.
What you need to change¶
| HKI Parcels Card | HA Parcel Card |
|---|---|
type: custom:hki-parcels-card |
type: custom:ha-parcel-card |
carrier type: postnl_v4 |
carrier type: postnl |
carrier type: postnl (PostNL <v4.x) |
update ha-postnl to 4.0.0 or newer, then type: postnl |
carrier type: postnl_legacy (PostNL ArjenBos) |
switch to ha-postnl 4.0.0 or newer, then type: postnl |
Change postnl_v4 to postnl
HA Parcel Card does not know the type postnl_v4. A carrier entry that keeps it is shown
as a generic custom carrier without PostNL detection or branding.
In HKI Parcels Card, type: postnl meant the old ha-postnl 3.x. In HA Parcel Card,
type: postnl means ha-postnl 4.0.0 and newer, so a card that used PostNL <v4.x keeps working
only after ha-postnl has been updated.
All other carrier types (dhl, dpd, gls, vinted_go and so on) keep their name.
Step by step¶
- Install HA Parcel Card, see Installation. Leave HKI Parcels Card installed for now.
- Reload your browser.
- Open the dashboard with your current card and choose Edit dashboard.
- Open the card's menu and choose Show code editor, copy the YAML, and add a new Manual card with that YAML.
- In the new card, change the first line to
type: custom:ha-parcel-cardand apply the carrier changes from the table above. - Save, and check that every carrier shows its parcels.
- Remove the old card from the dashboard.
- Once no dashboard uses it any more, remove HKI Parcels Card in the Marketplace (or HACS).
Prefer starting fresh? Add HA Parcel Card as a new card instead: it detects every installed carrier integration and fills in the carriers for you.
Something doesn't work after moving? Open an issue on ha-parcel-card.