Skip to main content

Importing data

Import ROS 1 (.bag) and MCAP (.mcap) data files into the Foxglove platform for later visualization and analysis.

Check out the MCAP docs for more information on converting other data formats – like ROS 2, Protobuf, JSON, and more – into the MCAP file format.

Import via UI

(Optional) Add devices

To organize files by the robot they were recorded on, create uniquely named devices for every real or simulated robot you want to track. Files do not have to be associated with a device to import them.

Click "Add device" on the Devices page to create your devices:

add device

Import files

Import data from the Recordings or Timeline page:

Recordings page

Alternatively, you can click on one of your created devices on the Devices page to go to its details page – from there, you can import data directly to that device.

Select the file you want to import, and the device you want to associate with the recording if desired:


When importing MCAP files with metadata records or attachments, Foxglove will index and display them under the Metadata and Attachments tabs on the recording's details page:

recording metadata

View recordings

View imported data as a list on the Recordings page, or as ranges on a timeline on the Timeline page.

Import via API

See for more information on importing data via the Foxglove API using an API key.