> ## Documentation Index > Fetch the complete documentation index at: https://help.hflow.pro/llms.txt > Use this file to discover all available pages before exploring further. # Getting started with hFlow > First-time setup: organization profile, languages, student roster, and assessment import. 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](#how-to-sign-in) and [Where to go next](#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](https://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](/hflow/students/roles-and-permissions). ## 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](/hflow/configuration/org-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. 3. Select the language in the list on the left if it is not already selected. 4. Choose **School Year** and **Grade Level** (for example 3rd grade). 5. 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). 6. 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](/hflow/languages) and [Tiers overview](/hflow/tiers). ## 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](https://drive.google.com/file/d/1p_8TBJ1PkXPIkVtXA1zNmPzzkK4BeJMQ/view?usp=drive_link) 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)](/hflow/students/add-students). ## 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](https://drive.google.com/file/d/1_GFATNrB2KCvAbLG3tBYAGSUMlIYNoon/view?usp=drive_link) 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](/hflow/assessments#import-assessments-from-csv). ## 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 * [Students overview](/hflow/students): filters, period cells, and student home page * [Assessments](/hflow/assessments): gradebook entry and CSV import * [Reports overview](/hflow/reports): tier distribution, growth, and language progress * [Troubleshooting](/hflow/troubleshooting): common questions * [Release notes](/hflow/changelog): recent product changes