Skip to main content
This guide walks school owners and administrators through the first login after your organization account is ready. Teachers who are invited later can skip to Sign in and Where to go next. When you sign in for the first time, Students may look empty. No roster rows, no scores. That is normal. Follow the steps below in order to add your school details, configure at least one program language, import students, then load test results.

​
Video walkthrough

Demo data notice
Examples in this help center use fictitious names and schools for training only.

​
How to sign in

  1. Open the hFlow app at app.hflow.pro.
  2. Enter the email and password from your invitation or setup message.
  3. Click Sign In.
After you sign in, you usually land on Students → View Students. If your login is not linked to a school yet, you may see a message that your account is not associated with an organization. Contact your hFlow contact or school lead; the full menu appears once linking is complete.
Teachers invited after setup typically see Students and Assessments only. Menu differences are summarized in Students: Admin vs Teacher.

​
Step 1: Set up your organization profile

  1. In the header, open Configuration.
  2. Choose Org Profile.
  3. Review Organization name and primary contact fields (they are often pre-filled for the owner).
  4. Add phone, notes, or secondary contact details if your school wants support to reach someone besides the primary owner.
  5. Click Save Changes.
After saving, a success message appears on the profile page. Updated contact details are used wherever hFlow shows school information to administrators. More detail: Organization profile.

​
Step 2: Add a language and review tiers

  1. In the header, click Languages.
  2. In the New Language box, type your program language (for example Hebrew) and click Add.
When you add Hebrew, hFlow applies a standard template of reading tier bands and benchmarks for all grades. Other language names start with generic tier defaults; you can adjust them the same way.
  1. Select the language in the list on the left if it is not already selected.
  2. Choose School Year and Grade Level (for example 3rd grade).
  3. Review Performance Tiers for Beginning, Middle, and End of Year. Tier sliders define accuracy and fluency ranges for Tier 1, Tier 2, and Tier 3 (for example, a third grader below 60% accuracy in Beginning of Year might fall in Tier 3, between 60% and 84% in Tier 2, and 85%–100% in Tier 1).
  4. Click Edit Tiers to change sliders, then Save Changes when finished.
Assessments and rosters use these bands immediately for the language, grade, period, and school year you configured. More detail: Languages and Tiers overview.

​
About CSV files

A CSV (comma-separated values) file is a plain text file you can open in a text editor or in spreadsheet apps such as Microsoft Excel, Google Sheets, Apple Numbers, and others. Each line is usually one row; columns are separated by commas. When you save a spreadsheet as CSV, use that file for Import CSV in hFlow.

​
Step 3: Import your students

  1. Open Students → View Students.
  2. Click Import CSV.
  3. Click the ? help control in the import panel to review required columns and rules.
  4. Prepare a spreadsheet saved as CSV with at least:
    • first_name, last_name, school_year (format 2025-2026), grade (0–12, where 0 is Kindergarten)
    • Optional: middle_name (helps when two students share the same first and last name), class (for example 5a or 5b. You do not create sections elsewhere; hFlow creates them from the file)
  5. Upload the file, confirm the row count on the preview screen, and click Proceed.
  6. Review results. Successful rows appear in the summary; errors show in red with an option to download a Failures report. Click Done when finished.
Example file (do not import as-is): Download students-upload-csv-sample.csv opens in Google Drive; use Download there to save the file. It shows fictitious names and columns in the format hFlow expects. Do not load this file into your school roster, use it only as a reference when you build your own CSV from your student data.
Imported students appear on the roster for that school year and grade. Reading and language cells stay blank until you add assessments.
Each student CSV is limited to 500 rows. Larger schools can split the file and import multiple times.
More detail: Add Students (Manual + CSV).

​
Step 4: Import test assessments

  1. Open Assessments from the header.
  2. Choose language, grade, and class context as shown on the page.
  3. Click Import CSV and use the ? help control for column names and validation rules.
  4. Prepare a CSV that includes the same student names as your roster file, plus:
    • Required on every row: first_name, last_name, school_year, grade, language, period (BOY, MOY, EOY, or full names such as Beginning of Year)
    • At least one score column per row: reading fields (total_words, errors, total_time together), comprehension, ACTFL levels (reading_actfl_level, listening_actfl_level, and similar), or domain comprehension columns
  5. Upload, confirm the count, click Proceed, then review successes and failures like the student import.
Example file (do not import as-is): Download assessments-upload-csv-sample.csv opens in Google Drive; use Download there to save the file. It matches the sample student names and includes Hebrew scores for school year 2025-2026. Import your student roster first (step 3). Do not load this file into your school, use it only as a reference when you build your own assessment CSV.
Re-uploading a corrected file updates existing assessments for the same student, year, period, and language. It does not create duplicates.
Assessment CSV files are also capped at 500 rows per upload. Split larger batches across multiple files.
More detail: Assessments: CSV import.

​
After setup

Your roster and gradebook should show color-coded reading tiers from the bands you set, plus reading and language scores where you imported them. You can add or edit individual assessments from a student’s home page or the gradebook, run Reports from the header, and configure Communications when your school uses template-based family messages.

​
Where to go next