Add a comprehensive entity reference system that helps users find entities across all 5 supported languages (EN, DE, NO, NL, SV). Core components: - Generator script (scripts/docs/generate-sensor-reference) that builds sensor-reference.md from translation files with --check mode for CI validation - EntityRef component for compact inline entity annotations with tooltip and version-aware linking to the reference table - EntitySearch component with live filtering, clickable results, keyboard navigation, "/" shortcut to focus, category filter chips, match highlighting, copy-entity-ID button per row, back-links to documentation pages, persistent row highlights, hash-based deep linking, and mobile-responsive layout - MDXComponents theme override for global component registration Documentation updates: - New sensor-reference.md page (115 entities x 5 languages) - EntityRef annotations across 10 documentation pages - Sidebar entry for quick navigation - CI integration (docusaurus.yml + scripts/check) - Ruff per-file-ignores for scripts/ (T201, INP001) Impact: Users can now find any entity by its localized display name regardless of their UI language. Inline EntityRef annotations link directly to the multi-language lookup table with version-aware URLs.
5 KiB
FAQ - Frequently Asked Questions
Common questions about the Tibber Prices integration.
General Questions
Why don't I see tomorrow's prices yet?
Tomorrow's prices are published by Tibber around 13:00 CET (12:00 UTC in winter, 11:00 UTC in summer).
- Before publication: Sensors show
unavailableor use today's data - After publication: Integration automatically fetches new data within 15 minutes
- No manual refresh needed - polling happens automatically
How often does the integration update data?
- API Polling: Every 15 minutes
- Sensor Updates: On quarter-hour boundaries (00, 15, 30, 45 minutes)
- Cache: Price data cached until midnight (reduces API load)
Can I use multiple Tibber homes?
Yes! Use the "Add another home" option:
- Settings → Devices & Services → Tibber Prices
- Click "Configure" → "Add another home"
- Select additional home from dropdown
- Each home gets separate sensors with unique entity IDs
Does this work without a Tibber subscription?
No, you need:
- Active Tibber electricity contract
- API token from developer.tibber.com
The integration is free, but requires Tibber as your electricity provider.
Configuration Questions
What are good values for price thresholds?
Default values work for most users:
- High Price Threshold: 30% above average
- Low Price Threshold: 15% below average
Adjust if:
- You're in a market with high volatility → increase thresholds
- You want more sensitive ratings → decrease thresholds
- Seasonal changes → review every few months
How do I optimize Best Price Period detection?
Key parameters:
- Flex: 15-20% is optimal (default 15%)
- Min Distance: 5-10% recommended (default 5%)
- Rating Levels: Start with "CHEAP + VERY_CHEAP" (default)
- Relaxation: Keep enabled (helps find periods on expensive days)
See Period Calculation for detailed tuning guide.
Why do I sometimes only get 1 period instead of 2?
This happens on high-price days when:
- Few intervals meet your criteria
- Relaxation is disabled
- Flex is too low
- Min Distance is too strict
Solutions:
- Enable relaxation (recommended)
- Increase flex to 20-25%
- Reduce min_distance to 3-5%
- Add more rating levels (include "NORMAL")
Troubleshooting
Sensors show "unavailable"
Common causes:
- API Token invalid → Check token at developer.tibber.com
- No internet connection → Check HA network
- Tibber API down → Check status.tibber.com
- Integration not loaded → Restart Home Assistant
Best Price Period is ON all day
This means all intervals meet your criteria (very cheap day!):
- Not an error - enjoy the low prices!
- Consider tightening filters (lower flex, higher min_distance)
- Or add automation to only run during first detected period
Prices are in wrong currency or wrong units
Currency is determined by your Tibber subscription (cannot be changed).
Display mode (base vs. subunit) is configurable:
- Configure in:
Settings > Devices & Services > Tibber Prices > Configure - Options:
- Base currency: €/kWh, kr/kWh (decimal values like 0.25)
- Subunit: ct/kWh, øre/kWh (larger values like 25.00)
- Smart defaults: EUR → subunit, NOK/SEK/DKK → base currency
If you see unexpected units, check your configuration in the integration options.
Tomorrow data not appearing at all
Check:
- Your Tibber home has hourly price contract (not fixed price)
- API token has correct permissions
- Integration logs for API errors (
/config/home-assistant.log) - Tibber actually published data (check Tibber app)
Automation Questions
Entity ID tip:
<home_name>is a placeholder for your Tibber home display name in Home Assistant. Entity IDs are derived from the displayed name (localized), so the exact slug may differ. Can't find a sensor? Use the Entity Reference (All Languages) to search by name in your language.
How do I run dishwasher during cheap period?
automation:
- alias: "Dishwasher during Best Price"
trigger:
- platform: state
entity_id: binary_sensor.<home_name>_best_price_period
to: "on"
condition:
- condition: time
after: "20:00:00" # Only start after 8 PM
action:
- service: switch.turn_on
target:
entity_id: switch.dishwasher
See Automation Examples for more recipes.
Can I avoid peak prices automatically?
Yes! Use Peak Price Period binary sensor:
automation:
- alias: "Disable charging during peak prices"
trigger:
- platform: state
entity_id: binary_sensor.<home_name>_peak_price_period
to: "on"
action:
- service: switch.turn_off
target:
entity_id: switch.ev_charger
💡 Still need help?