Skip to content

HA Parcel Card

A multi-carrier parcel tracking card for Home Assistant. Track parcels from all 90 carriers of the ha-parcel-integrations family โ€” PostNL, DHL, DPD, UPS, FedEx, USPS, GLS, bpost, La Poste, Evri and many more โ€” in a single unified view, with support for letterbox mail images.

Note

This card was created for the visual editor in Home Assistant. It is possible that the documentation is not complete for all features.


Requirements

This card requires at least one parcel-tracking integration to be installed in Home Assistant. See Installation for the full list and links.

Every supported carrier, with its integration and what it supports, is listed under Carrier types.


Features

๐Ÿ“ฆ Parcel tracking

  • Multi-carrier โ€” any of the 93 supported carriers side by side; add the same carrier multiple times for multiple accounts or hubs
  • Automatic sensor names โ€” enter only the account name; the card builds all sensor entity IDs automatically, for both known naming schemes
  • Four tabs โ€” In Transit ยท Delivered ยท Sent ยท Letters
  • Split sections โ€” both Sent and Letters are split into Still to be delivered and Delivered
  • Click-to-expand โ€” click any parcel for barcode, delivery type and a direct tracking link
  • Delivery tracker for every carrier โ€” selecting a parcel shows Registered ยท Sorting centre ยท Out for delivery ยท Delivered, with an extra Pickup point step for parcels delivered via an official pickup point. All 93 carriers and custom share five inline SVG scenes, coloured from the configured carrier colour
  • Historical tracking โ€” configure how many days back delivered parcels remain visible

Carrier overview popup

Click a carrier's logo in the multi-carrier combo banner to open a popup listing every item for that carrier โ€” parcels and letters โ€” across all four tabs, grouped by section. Clicking an item expands its details (tracking number, status, delivery type, tracking link) in place, using the same accordion behaviour as the main list, so the popup stays open while you browse.

Add parcel support

For every carrier whose integration has a track_parcel service โ€” the tracking-code carriers, plus account-based ones that also accept a code, such as An Post, bpost and DHL โ€” the card shows a "Add parcel" control that calls the integration's own track_parcel service directly โ€” the parcel is genuinely registered with the integration, not just added to the card's own view. Toggle it off with show_add_parcel: false if you'd rather add parcels through the integration itself.

Which carriers have it is listed under Carrier types. Account-based integrations without such a service (PostNL, DHL NL, DPD, Vinted Go, ...) don't need it: every parcel on the account appears automatically.

For GLS and Trunkrs, which can have multiple hubs (one per postal code), the carrier's configured user value is passed along automatically so the parcel lands on the right hub.

๐Ÿ“ง Letterbox mail

  • PostNL, bpost and USPS letters โ€” dedicated tab with scan images matched automatically from image.* entities
  • Works across ha-postnl versions โ€” matching is based on the mailitem-xxx ID, not the entity name, so it survives integration updates

๐ŸŽจ Visual interface

  • Carrier banners โ€” animated banner shown when no parcel is selected. With one carrier configured, that carrier's own banner/logo is shown. With two or more, the card automatically builds a combo banner from the logos of only the carriers you've actually configured
  • Custom branding โ€” configurable logo, van animation and banner per carrier
  • Header statistics โ€” shows count of parcels in transit and recently delivered
  • Carrier colours โ€” each carrier has its own accent colour, editable per carrier
  • PHU icons โ€” branded carrier icons via custom-brand-icons when installed (coverage varies โ€” see Installation)

The delivery illustrations work without PHU, card-mod or browser_mod. Logos sit inside fixed panels: a released PHU icon takes priority, followed by the carrier's existing logo, then a plain panel in the carrier colour. App-icon fallbacks have rounded corners. PHU logo colours are darkened automatically when needed for at least 3:1 contrast on white. Registered and Delivered have no logo. The current driving hero keeps the existing vehicle GIF or carrier chip. Explicit step-image overrides take precedence over the shared scenes.

๐Ÿ”ง Customization

  • Toggle elements โ€” show/hide header, tabs, animation and placeholder
  • Layout reordering โ€” change the order of header, animation, tabs and list
  • Visual editor โ€” full configuration through the Home Assistant UI; sensor accounts are detected automatically
  • Media browser โ€” browse the HA media library from the editor to select logos, banners and placeholder images
  • Colour picker with hex input โ€” set custom carrier and header colours with one-click reset to the carrier default