Overview
OpenFIT supports multiple import templates depending on the type of data you need to load. You do not need to include session or survey data if you simply want to import providers, clients, and cases.
OpenFIT automatically detects which template you are using based on the columns present in your file. Simply include the columns relevant to your import and OpenFIT will handle the rest.
For detailed information on importing ORS and SRS survey scores, including validation rules and skip flags, see Importing Data into OpenFIT.
Choosing the Right Template
| I want to import… | Template |
|---|---|
| Providers, clients and cases only | Template 1 — Provider / Client / Case |
| Providers, clients, cases and collateral raters | Template 2 — With Collateral Raters |
| Providers, clients, cases and sessions (no survey scores) | Template 3 — With Sessions |
| Providers, clients, cases, sessions and collateral raters | Template 4 — With Sessions & Collateral Raters |
| Everything including ORS/SRS survey scores | Template 5 — Full Import |
Field Reference
Provider Fields
| Column | Required | Description |
|---|---|---|
Service_Location | Yes | Name of the provider location. Must match an existing location in OpenFIT. |
Provider_Email | Yes | Email address (unique). Used as the OpenFIT username. If the user does not exist, OpenFIT will create one with a default Clinician role. |
Provider_FirstName | Yes | First name of the clinician. |
Provider_LastName | Yes | Last name of the clinician. |
Provider_ID | No | Optional external identifier for the provider. |
Client Fields
| Column | Required | Description |
|---|---|---|
Client_ID | Yes | Unique identifier for the client. |
Client_FirstName | Yes | Client's first name. |
Client_LastName | Yes | Client's last name. |
Client_Gender | Yes | One of: Male, Female, Transfeminine, Transmasculine, GenderExpansiveNonBinary, TwoSpirit, Questioning, DeclinedToState, AdditionalCategory |
Client_Group | Yes | Client group classification (e.g. Adult, Child, Couple, Family, Group). |
Client_Age | Yes | Client's age at the time of the case. |
Client_Status | Yes | Client status (e.g. Active, Inactive). |
Client_Language | No | Client's preferred language. |
Client_Tags | No | Optional tags for the client record. |
Case Fields
| Column | Required | Description |
|---|---|---|
Case_ID | Yes | Identifier used to group sessions for a client. |
Case_Date | No | Start date of the case. Format: yyyy-MM-dd |
Case_Tags | No | Optional tags for the case record. |
Notes | No | Saved when the case (episode) is created. |
Session Fields
Only required when importing session data (Templates 3, 4 and 5).
| Column | Required | Description |
|---|---|---|
Session_ID | Yes | Sequential integer within the case (1, 2, 3…), where 1 represents the earliest session by date. |
Session_Date | Yes | Date of the session. Format: yyyy-MM-dd |
Session_Key | No | Optional external key for the session. |
Collateral Rater Fields
Only required when importing collateral rater data (Templates 2, 4 and 5).
| Column | Required | Description |
|---|---|---|
ColRater_ID | Yes | Unique identifier for the collateral rater. |
ColRater_Type | Yes | Type of collateral rater (e.g. parent, guardian, teacher). |
ColRater_FirstName | Yes | First name of the collateral rater. |
ColRater_LastName | Yes | Last name of the collateral rater. |
ColRater_Gender | No | Gender of the collateral rater. Uses the same values as Client_Gender. |
ColRater_Language | No | Preferred language of the collateral rater. |
ORS/SRS Survey Fields
Only required for the Full Import (Template 5). For detailed validation rules, see Importing Data into OpenFIT.
| Column | Required | Description |
|---|---|---|
ORS_Skip | Yes | Y if the ORS was not completed, N if it was. |
ORSQ1 – ORSQ4 | Conditional | ORS subscores. Required when ORS_Skip = N and Total_ORS is blank. |
Total_ORS | Conditional | Total ORS score. Required when ORS_Skip = N and subscores are blank. |
SRS_Skip | Yes | Y if the SRS was not completed, N if it was. |
SRSQ1 – SRSQ4 | Conditional | SRS subscores. Required when SRS_Skip = N and Total_SRS is blank. |
Total_SRS | Conditional | Total SRS score. Required when SRS_Skip = N and subscores are blank. |
Templates
Template 1 — Provider / Client / Case Only
Use this template when you want to set up providers, clients and cases in OpenFIT without any session or survey data.
Columns:
Service_Location,Provider_FirstName,Provider_LastName,Provider_Email,Case_ID,Case_Date,Client_ID,Client_FirstName,Client_LastName,Client_Gender,Client_Group,Client_Age,Client_Status,Notes
Example:
| Service_Location | Provider_FirstName | Provider_LastName | Provider_Email | Case_ID | Case_Date | Client_ID | Client_FirstName | Client_LastName | Client_Gender | Client_Group | Client_Age | Client_Status |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Main Clinic | Jane | Smith | jsmith@example.org | CASE-001 | 2025-01-15 | CL-1001 | Alex | Johnson | Male | Adult | 34 | Active |
| Main Clinic | Jane | Smith | jsmith@example.org | CASE-002 | 2025-02-01 | CL-1002 | Sam | Lee | Female | Adult | 28 | Active |
| Outreach Office | Mark | Torres | mtorres@example.org | CASE-003 | 2025-02-10 | CL-1003 | Jordan | Park | GenderExpansiveNonBinary | Child | 14 | Active |
Template 2 — With Collateral Raters
Use this template when you also need to import collateral raters (e.g. parents, guardians, or teachers) linked to a client's case.
Columns:
Service_Location,Provider_FirstName,Provider_LastName,Provider_Email,Case_ID,Case_Date,Client_ID,Client_FirstName,Client_LastName,Client_Gender,Client_Group,Client_Age,Client_Status,ColRater_ID,ColRater_Type,ColRater_FirstName,ColRater_LastName,Notes
Example:
| Service_Location | Provider_FirstName | Provider_LastName | Provider_Email | Case_ID | Client_ID | Client_FirstName | Client_LastName | Client_Gender | Client_Group | Client_Age | Client_Status | ColRater_ID | ColRater_Type | ColRater_FirstName | ColRater_LastName |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Outreach Office | Mark | Torres | mtorres@example.org | CASE-003 | CL-1003 | Jordan | Park | GenderExpansiveNonBinary | Child | 14 | Active | CR-2001 | Parent | Lisa | Park |
Template 3 — With Sessions
Use this template when you want to import session records but do not need to include ORS/SRS survey scores.
Columns:
Service_Location,Provider_FirstName,Provider_LastName,Provider_Email,Case_ID,Case_Date,Session_ID,Session_Date,Client_ID,Client_FirstName,Client_LastName,Client_Gender,Client_Group,Client_Age,Client_Status,Notes
Example:
| Service_Location | Provider_FirstName | Provider_LastName | Provider_Email | Case_ID | Case_Date | Session_ID | Session_Date | Client_ID | Client_FirstName | Client_LastName | Client_Gender | Client_Group | Client_Age | Client_Status |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Main Clinic | Jane | Smith | jsmith@example.org | CASE-001 | 2025-01-15 | 1 | 2025-01-15 | CL-1001 | Alex | Johnson | Male | Adult | 34 | Active |
| Main Clinic | Jane | Smith | jsmith@example.org | CASE-001 | 2025-01-15 | 2 | 2025-01-22 | CL-1001 | Alex | Johnson | Male | Adult | 34 | Active |
Template 4 — With Sessions & Collateral Raters
Use this template when you need to import sessions together with collateral rater information.
Columns:
Service_Location,Provider_FirstName,Provider_LastName,Provider_Email,Case_ID,Case_Date,Session_ID,Session_Date,Client_ID,Client_FirstName,Client_LastName,Client_Gender,Client_Group,Client_Age,Client_Status,ColRater_ID,ColRater_Type,ColRater_FirstName,ColRater_LastName,Notes
Template 5 — Full Import (with ORS/SRS Scores)
Use this template when you want to import everything including ORS and SRS survey scores. For full details on score validation rules, see Importing Data into OpenFIT.
Columns:
Service_Location,Provider_FirstName,Provider_LastName,Provider_Email,Case_ID,Case_Date,Session_ID,Session_Date,Client_ID,Client_FirstName,Client_LastName,Client_Gender,Client_Group,Client_Age,Client_Status,ORS_Skip,ORSQ1,ORSQ2,ORSQ3,ORSQ4,Total_ORS,SRS_Skip,SRSQ1,SRSQ2,SRSQ3,SRSQ4,Total_SRS,Notes
Example — Session with ORS subscores, SRS skipped:
| Session_ID | Session_Date | ORS_Skip | ORSQ1 | ORSQ2 | ORSQ3 | ORSQ4 | Total_ORS | SRS_Skip | SRSQ1 | SRSQ2 | SRSQ3 | SRSQ4 | Total_SRS |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 2025-01-15 | N | 6.5 | 7.2 | 5.8 | 6.0 | Y | ||||||
| 2 | 2025-01-22 | N | 25.5 | N | 8.1 | 7.5 | 9.0 | 8.4 |
Note: The example above shows only the session and score columns for clarity. The full template includes all provider, client and case columns as well.
Custom Fields
All templates support custom fields. To include a custom field, add a column to your file using the naming convention:
{EntityName}_{FieldName}
Where {EntityName} is typically Episode or Client. The column values must match the visible values shown in the OpenFIT UI — do not use GUIDs or internal IDs.
Example: An Episode-level custom field called "Treatment Settings" would appear as the column Episode_TreatmentSettings with values such as Outpatient, Inpatient, Residential, or Other.
If you need help identifying the correct field name, you can inspect the data-translate attribute in browser DevTools or contact support@openfit.care.
Important Notes
- Column order does not matter — OpenFIT reads columns by name, not position.
- Auto-detection — OpenFIT automatically determines the import type based on which columns are present in your file. There is no need to specify the template type manually.
- Optional columns can be omitted entirely — you do not need to include blank optional columns.
- Large imports and ETL migrations — for initial data loads or migrations from another outcome measurement system, please contact us during the planning phase. We can support validation and testing in a Sandbox environment before importing into Production.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article