Skip to main content

Driver Lap Times

Follow positions, gaps, last laps and personal bests in a detailed timing table. Add lap-history columns when you want to compare a driver’s recent pace.

Driver Lap Times card showing its dashboard layout
Example Driver Lap Times layout. Appearance depends on your session, version and display options.Select the image to open it full size.

Availability

Public live / Replay. Enable Driver Positions and Driver List. Core timing uses public live data or archived replay timing. Lap-history columns depend on the laps available in the current session data.

Add the card

  1. Open your dashboard, select Edit dashboard, then Add card.
  2. Search for F1 and select the Driver Lap Times card.
  3. Select Driver Positions under Data Sources and confirm Driver List. Start with lap history off for a compact live table. If you enable history, set a small recent-lap limit on narrow dashboards.
  4. Select Save.

If the card is missing from the picker, follow Card installation. With more than one F1 Sensor entry, use the sources from the same entry; see Entity selection.

Minimal YAML

Use this in a manual dashboard card. Replace any entity ID with the one in your installation if it differs.

type: custom:f1-driver-lap-times-card
positions_entity: sensor.f1_driver_positions
theme_mode: auto

Use the card

Switch the gap reference between the car ahead and the leader using the visible toggle. Lap trends show whether times became faster or slower. Supported Weekend Hub context selections can also change the focus driver and gap reference.

Configuration

Data sources

The defaults below are the card’s fallback values. Automatic discovery connects standard sources to the selected integration entry, including renamed entity IDs. See Entity selection.

OptionDefaultDescription
drivers_entitysensor.f1_driver_listDriver List for names, teams and driver detail. Select the entity from your F1 Sensor entry.
positions_entitysensor.f1_driver_positionsDriver Positions for timing and running order. Select the entity from your F1 Sensor entry.
no_spoiler_entityswitch.f1_no_spoiler_modeEntity whose on state enables spoiler protection. See No Spoiler Mode.

Display and behavior

OptionDefaultDescription
theme_modedarkdark, light or auto; auto follows Home Assistant. See Appearance.
titleDriver Lap TimesCard title
show_headertrueShow the card header
show_table_headertrueShow column labels
show_positiontrueShow current position
show_team_logotrueShow team logo
show_tlatrueShow driver TLA
show_full_namefalseShow full driver names
show_statustrueShow driver status
show_gaptrueShow gap or interval
gap_modeaheadahead for the interval to the car ahead, or leader for the gap to P1.
show_gap_toggletrueShow the gap mode toggle
show_last_laptrueShow last lap time
show_best_laptrueShow personal best lap time
show_lap_historyfalseShow lap-by-lap history columns
lap_history_limit0Number of recent lap columns. 0 shows all laps.
show_lap_trendtrueShow faster/slower trend indicators
team_logo_stylecolorcolor or white for team logos.
font_stylewidewide, balanced or system. See Typography.

All bundled cards also support f1_entry_id and card actions. Home Assistant layout settings remain available in the dashboard editor.

When data is missing

No lap history before timed laps arrive is normal. A driver can have a position without a valid completed lap. For an empty table during a session, verify both source entities are enabled and contain drivers.

For an Entity not found message, check the selection in Data Sources and confirm that the entity is enabled in F1 Sensor. For a missing card type or an old interface after an update, use the card loading checks.