Find and fix a problem

Choose the symptom closest to what you see. Check your installed version and whether you are using live timing, Replay Mode or schedule data before changing settings.

Where to start

What you see	Check first	Next step
F1 Sensor is missing from Add integration	Installation completed and Home Assistant restarted	Installation
No F1 cards in the dashboard picker	Restart after update, then refresh the browser	Card installation and migration
A card says an entity is missing	Feature enabled and correct entity selected	Configuration
Live entities are inactive	There is an active/upcoming session and live data is enabled	No live updates
Track Map has no cars	Session, token health and position-data availability	Track Map status messages
Data arrives before the TV picture	Broadcast delay is not yet matched	Live Delay
Replay session is missing	Correct season selected, session list loaded, and archive available	Replay setup
Results remain frozen	No Spoiler Mode is still on	No Spoiler Mode
Token pairing fails	Original pairing tab is active and link has not expired	Token Helper troubleshooting
Recorder warns about large attributes	A large result sensor is being recorded	Recorder guidance

No live updates

1. Open F1 Sensor Reconfigure and confirm Enable live F1 API is on.
2. Check that the required features are selected. A card cannot enable an integration entity for you.
3. Check sensor.f1_current_session and sensor.f1_session_status. Between sessions, waiting is normal.
4. Check switch.f1_no_spoiler_mode. If it is on, live delivery is intentionally stopped.
5. If Replay Mode is active, stop it when you want to return to live timing.
6. For an authenticated feature, check sensor.f1_f1tv_token_status and the availability matrix.

If a diagnostic entity is disabled or has a different ID, find it in the integration's entity list before copying a reference into your dashboard.

A replay session is missing

1. Check the year selected in select.f1_replay_year.
2. Refresh the session list with button.f1_replay_refresh.
3. Inspect sensor.f1_replay_status for index_error or download_error.
4. If the session just ended, try again later. Formula 1 controls when archived timing becomes available.

See Replay Mode for loading and playback, and Replay controls for status fields.

Missing entity or old card

An existing installation may use entity IDs different from the examples. Select your actual entities in the card's visual editor. Do not rename working entities just to match a guide.

After updating, restart Home Assistant and refresh the browser. Follow the migration guide if you used the old standalone card. Confirm the bundled card works before removing old resources.

Still not working?

Collect debug logs, reproduce the issue once, and choose the right support channel. Include the F1 Sensor and Home Assistant versions, session/mode, expected result and actual result. Review files for credentials before sharing them.

For short answers, browse the FAQ.