Skip to content
  • There are no suggestions because the search field is empty.

Data Overview: How Data is Organized in Labfront

Learn how the physiological data and task/questionnaire data is separated and organized in Labfront.


This article explains how Labfront files are organized so you can better understand your data once it’s been downloaded.

💡 Before you begin

If you haven’t yet downloaded your data, start with How to download your data first.

In this article: 


Overview of data files and folders

When you download your project data, Labfront creates a single ZIP file containing all participants’ data.

 

Each participant has their own folder labeled with:

  • Participant Insignia (the name entered by the researcher)
  • Participant ID (unique identifier)

HC_Data_Folders

Inside each participant’s folder, you’ll find subfolders for:

  • Physiological data
    • garmin-device (high-resolution data)
    • garmin-connect (summary data)
    • movesense-stream (Movesense recordings)

  • To-Do tasks → todo
  • Timer tasks → timer
  • Questionnaires → questionnaire

Each task or questionnaire folder is further divided by specific task or questionnaire name.
Inside those subfolders, you’ll find the related CSV files. 
 
HC_data_questionnaire
 

How the CSV files are organized 

  • Files are sequentially numbered: 000000, 000001, 000002, etc.
    (New files are created automatically if row limits are exceeded.)

    HC_data_BBI
  • Each CSV file starts with a Header section containing project and participant details.
    • The Header length (e.g., “5”) indicates the number of non-data rows.
HC__Data__File__Movesense__Header (1)
 

⏰ Note

All data entries are timestamped so you can precisely identify when data was collected or tasks were completed.

 

Physiological data

Garmin data

Depending on your data sources, Garmin files appear in:

  • garmin-device: high-resolution data (e.g., BBI, sleep actigraphy, 3-axis ACC )
  • garmin-connect: summary data (e.g., stress, HR)

Each row = one data recording.

Example: Participant BBI data

HC_data_BBI-CSV

👉 Learn more: Garmin data metrics and meanings

 
 
Movesense data

Movesense data are stored in the movesense-stream folder.

HC__Data__File__Movesense-Stream (1)

Each Movesense task has:

  • A task-specific folder
  • Inside it: folders for each instance and data type (e.g., movesense-stream-IMU, movesense-stream-rr)

HC__Data__File__Movesense

Each row = one data recording.

Example: IMU data file

HC__Data__File__Movesense__IMU (1)

👉 Learn more: Movesense data format

 

To-Do task data

  • Stored in the todo folder, organized by each To-Do Task.
  • Each CSV row represents one task completion.
  • All entries are timestamped.
👉 See variable details: To-Do data variable table
 
 

Timer data

  • Stored in the timer folder.
  • Each row represents a single recorded timer event.
  • All entries are timestamped.

👉 See variable details: Timer data variable table

 

Questionnaire data

The questionnaire folder contains data from all Labfront questionnaires.

Each CSV file includes:

  • Questionnaire Key 💛 (metadata about questions/options)
    • The Key Length (e.g., “8”) indicates how many rows are part of the key.
  • Participant Responses ❤️, arranged in columns by question:
    • Format: SectionIndex_QuestionIndex (e.g., 1_1 = Section 1, Question 1)

HC__Data__File__Questionnaire

Refer to the key for question details and option labels.

👉 Learn more: Understanding questionnaire keys and variables

 
 

Sample participant data

View a sample of the downloadable data format here. 

 

Data documentation resource

Access our data documentation PDF for a data dictionary of metrics you can collect with Labfront and their meanings image 173 (2) . 
 
 
 

Data FAQs

Do you offer any services to help analyze the data? 

We do! Our team of experts has over 20+ years of experience in digital biomarkers and research analytics. You can outsource your analytics to us and save up to several months of work. Learn more about Labfront Analytics here. 
 

Why can't I see my participants' data?

 

Data will only appear for Live projects with participants who are connected and actively contributing via the Labfront Companion app. To verify participant connections, check the Participants section on your Dashboard—ensure at least one participant is signed in, with their Invite Code marked as Used and Status as Joined. For further guidance, see our article on adding participants.
 
 

I can't download a ZIP file from my work computer. What should I do?

In this case, we recommend you ask your IT department how to allow ZIP file extraction on your work computer. Alternatively, you can also download on another computer or device that allows for ZIP downloads as we can only provide ZIP files for data downloads.
 

Can I filter my data download by a specific time period or group of participants?

Yes, you can filter your data download by participant and time period. Learn more about preparing your data download in this article. 

How can I understand what the variables mean?

Refer to our data dictionary, which provides clear definitions for every data variable included in your download.
 

Can I see a sample of the downloadable data format? 

You sure can! Take a look at a sample of our data here.