Skip to content

Vehicle Catalog

Danvanf edited this page Oct 23, 2026 · 3 revisions

Vehicle Catalog and device assignments

Vehicle Catalog describes the app-owned vehicle. A Traccar device describes its tracker. Their assignment connects tracker history to the vehicle, while the protocol profile explains how to interpret its telemetry.

Add or edit a vehicle

  1. As an administrator, open Settings → Vehicle Catalog on a screen at least 1024 CSS pixels wide.
  2. Choose a record under Edit vehicle, or choose New vehicle.
  3. Enter Name, VIN, Year, Make, Model, and Notes as needed.
  4. Choose a Device Protocol Profile for the tracker, or None (no translation) where appropriate.
  5. Choose its Traccar Device, then review Profile effective from and Device binding effective from.
  6. Choose Save Vehicle.

Vehicle configuration with identity values covered and VIN blurred

The profile and device effective times are part of their assignment histories. When moving hardware between vehicles, use the actual changeover time and review existing assignments. Overlapping assignments can conflict with historical trip ownership.

Review current assignments

Scroll to Current Device Assignments within Vehicle Catalog. The list identifies assigned and unassigned Traccar devices. Choose Refresh Assignments to reload it.

An unassigned tracker can exist in Traccar without being linked to a catalog vehicle. Check this section when a vehicle's imported trips or status do not match the hardware you expected.

Configure telemetry visibility

The field list combines the selected protocol profile with fields found in this vehicle's recorded history. The inventory count tells you how many received keys were found; the larger available-choice count can include profile fields that have not been received.

Light-green labels mean this field was observed in the vehicle's history. This does not mean it was recorded in every point or that it is selected for display. Search by field name or received key using Filter available fields.

The field grid has two controls for each measurement:

  • Checkbox: show the measurement in the Vehicle Status card.
  • Switch: show the measurement in map point popups.

Field selection controls

Turn on Show only received fields to hide choices without history evidence. It becomes available after the inventory scan completes. It combines with the text search; switch it off to show all known choices again. These filters do not change the field selections you have made.

Received-only field filter

Choose Save Status Card Fields after changing the selection. A selected field still needs corresponding recorded data and a suitable mapping before it can display a value.

See Map point telemetry for an example of reading both displays together.

Vehicle email sender

Email sender for this vehicle offers an optional Sender mailbox override. Leave it blank to use the default configured in Email Alerts. Choose Save Vehicle Sender to save an override. The configured Graph application must be permitted to send from that mailbox.

For broader setup, see Settings and vehicle setup. For translations shared by several vehicles, see Device Protocol Profile Editor.

Clone this wiki locally