Bulk importing behavior data allows you to sync information from your Student Information System (SIS) directly into Minga. This process ensures that your automated consequence workflows remain accurate without requiring manual entry for every individual incident. By the end of this article, you will know how to format your data, upload it to the dashboard, and verify the import results.

Permission Level Required: Owner | Manager | FlexManager

Import Requirements

Before you begin your import, you must ensure your data file is formatted correctly. Minga requires specific identifiers to match the behavior data to the correct student records.

Export your behavior data from your SIS as a .csv or .xlsx file.
Verify that the file contains a column for student identification.
- You must use either Student ID numbers or School Emails.
Ensure the behavior you are importing already exists as a category in Minga.
- If the behavior (e.g., "Tardy") is not yet created, navigate to Behaviors > Configuration to add it first.

Bulk Importing Behavior Data

Once your file is prepared, you can upload the data through the Behavior Dashboard. This action triggers any automated consequences associated with the behavior counts.

Step-by-step Guide to Importing a Behavior Spreadsheet

Export your behavior file from your SIS.
○ Create a .csv or .xlsx file that includes at least one unique identifier per student record.
○ Include ID Number or Email Address so Minga can match each row to the correct student.
Open Behaviors and select the Dashboard tab.
○ Locate Behaviors in your Minga navigation.
○ Click the Dashboard tab to access imports and reporting tools.
Click Import.
○ The Import workflow opens and prompts you to select what you want to import.
Choose your desired Behavior.
○ Select the behavior type you want to import (for example, tardies or attendance-related behaviors).
○ Confirm the behavior selection matches the data contained in your SIS export.
Click Next.
○ The upload screen appears and prompts you to attach your SIS export file.
Upload your SIS export file.
○ Select your .csv or .xlsx file from your device.
○ Confirm your file includes ID Number or Email Address for every row you want imported.
Review the Import Summary.
○ After processing completes, an Import Summary screen appears showing imported records and any failures.
○ Use the summary to confirm the import created the expected number of behavior records.

Tip: If you run a daily behavior import, export the file on a consistent schedule so behavior records align with the same school day in your SIS.

Reviewing Import Results

After the upload is processed, Minga provides a summary to ensure all data was recorded correctly.

Step-by-Step Guide to Reviewing Import Results

View the Import Summary screen that appears automatically.
- This screen displays the total number of records processed, successful imports, and any errors.
Review the Errors list if any records failed to import.
- Records typically fail if the Student ID does not match an existing user in Minga.
Click Done to return to the Behavior Dashboard.

Tip: Perform imports daily if you use Minga to automate tardy consequences. This ensures students receive notifications and passes immediately after their SIS data is synced

Troubleshooting

Issue: The import does not link records to students.
Solution: Make sure that your file contains a unique identifier for the student such as student ID Number or Email Address and that the values exactly match the student profile identifiers in Minga.

Issue: The Import Summary shows fewer records than expected.
Solution: Confirm row counts by checking your SIS export includes one row per behavior record you want imported and that the file upload completed without truncation.

FAQs

Can I import tardies from my SIS into Minga every day?

Yes! You can import tardies from your SIS into Minga every day by exporting a .csv or .xlsx file from your SIS and uploading it through Behaviors > Dashboard > Import.

What identifier does my SIS file need for a behavior import?

Your SIS file needs ID Number or Email Address for a behavior import so Minga can match each row to the correct student.

Who can bulk import behaviors in Minga?

Owners, Managers, Teachers, and Staff can bulk import behaviors in Minga using the Import workflow under Behaviors.

Where do I see results after I upload my SIS behavior file?

You can see results after you upload your SIS behavior file on the Import Summary screen, which appears after processing completes.

Import Parent Contact Information in Minga

Bulk Import SIS Behaviors into Minga

In this article: