Repository navigation
Offers card
custom:smartdiscounts-card shows the offers of your supermarkets and matches them with a shopping list. It is
a project of its own with its own version number and runs with and without SmartLists. Since SmartLists 4.0.0-beta.7
it is no longer shipped with SmartLists: add its own repository to HACS as a custom
repository (type Dashboard), install "SmartDiscounts" and reload the browser. When it is missing although a
dashboard uses it or a watch list is kept, SmartLists says so under Settings → Repairs. The README there lists every
option with examples.
At least one sensor with a list of offers in an attribute, e.g. from the integrations by FaserF for REWE, EDEKA, Lidl, ALDI and Norma (all projects). Any other sensor with such a list works too. Your own REST, template or scrape sensors work as well.
type: custom:smartdiscounts-card
list: todo.shopping- My list: for every open item the matching offers per store, the cheapest marked ★. "Pick cheapest" or "only REWE" selects for the whole list; "Apply to list" writes store, price and validity to the items.
- All offers: one shelf per store with search and categories – as tiles or as a list with small images.
- ⭐ Watch list: products you are waiting to see on offer.
The card speaks German, English, French, Spanish, Italian and Polish and follows the language of Home Assistant.
| Option | Default | Description |
|---|---|---|
list |
– | To-do list to match offers against |
title |
"Offers" | Heading |
sources |
auto |
auto, or a list of sources (see below) |
match |
word |
word (butter ≠ butter biscuit), exact, part
|
default_tab |
list |
list, all or watch
|
list_view |
chips |
"My list": chips (prices side by side), rows (one offer per row), compact (one line per item) or table (stores as columns) – switchable in the card |
all_view |
tiles |
"All offers" as tiles or as a list with small images |
show_images |
true |
Product images |
show_unit_price |
true |
Unit price (€/kg, €/l) |
show_valid_until |
true |
"until 21.11." |
hide_without_offer |
false |
Hide list items without an offer |
max_per_store |
10 |
Offers per store before "all →" (1–20) |
currency |
EUR |
ISO currency code |
currency_symbol |
– | Own symbol instead of currency, e.g. ₺
|
watch |
– | Watch list: fixed products, e.g. [coffee, chocolate spread]
|
watch_list |
– | Watch list as a to-do list – the same on all devices |
notify |
false |
Home Assistant notification when a watched product is newly on offer |
notify_targets |
– | Also send to these targets, e.g. [notify.mobile_app_pixel] (several possible) |
category_map |
– | Link store categories to your own, e.g. { Dairy: Chilled, Store: "" }
|
locked |
– | Fix a view so it cannot be switched inside the card: [list_view, all_view, group_by, add_to] or true
|
The card recognises common field names by itself. For everything else you map the fields: on the left the field of
the card, on the right the field of your sensor. Only name and price are required; a dot reaches into nested
data (images.0.url).
| Field | Meaning | Recognised automatically as |
|---|---|---|
name |
Product name (required) |
product, title, name, product_name, description
|
price |
Offer price (required) |
price, new_price, discount_price, offer_price, sale_price, price_euro, current_price
|
old_price |
Old price, struck through |
old_price, regular_price, original_price, was_price
|
discount |
Discount, e.g. "-44%" |
discount, discount_percent, savings
|
unit |
Unit price as text, e.g. "1 kg = 5,16 €" |
price_per_unit, base_price, unit_price
|
image |
Image address |
picture_link, image_url, image, picture, img, thumbnail
|
until |
Valid until (YYYY-MM-DD) |
valid_until, end_date, valid_to, until
|
category |
Category for the filter |
category, categories, group
|
brand |
Brand (searchable) |
brand, manufacturer
|
store |
Store of this one offer |
store, market, retailer, advertiser
|
type: custom:smartdiscounts-card
list: todo.shopping
sources:
- auto
- entity: sensor.my_store
attribute: results
store: Kaufland
color: "#e10915"
map:
name: product.name
price: prices.current
old_price: prices.regular
image: images.0.url
until: validity.toWith SmartLists the card uses the household's watch list (see Offers and prices): it is the same on all devices, and Home Assistant reports new offers even with no dashboard open.
Without SmartLists the watch list comes from watch: in the configuration, from a to-do list (watch_list:, editable in the card and
the same on all devices) or – without one – from what you enter in the tab, stored on that device only.
With notify: true the card creates a Home Assistant notification when a watched product is newly on offer.
The check runs in the card, so it reports while a dashboard with the card is open (e.g. a wall tablet). For
notifications without an open dashboard use an automation – the README of the card has an example.
- A chosen offer appears as a badge on the item with store, price and "valid until".
- The shopping list shows a 🏷️ hint on items that are on offer (see Offers and prices).
- Expired offers are pointed out in both cards and removed with one tap.
No discount shown? Not every sensor delivers an old price – then the card shows price and unit price.
"Butter" finds "butter biscuit"? match: word prevents that; exact is stricter still.
A store is missing? Check that the sensor has a list in one of the attributes discounts, offers, deals,
items, results or products – otherwise name it with attribute:.
SmartLists
Getting started
Using the lists
Offers and prices
Where it runs
Help
Deutsch