Logo

mybb Support

Mass Importing and Exporting Data

Last updated December 30, 2024

Updating Existing Accounts

You can mass update any existing field attached to student accounts except Email and Type. These fields must remain the same.

This process is commonly used for updating grades.


1) Export Existing Accounts

  • Navigate to the 4-square icon in the top right corner of your dashboard.
  • Select Admin Tasks from the link panel.
  • First, you will need to export the existing account information. From the Admin Tasks page (Image 1), select the blue Export button from the Export Accounts box.
  • You will be prompted to download the .csv file


2) Update CSV File

  • Open the downloaded file (Image 2 is an example file).
  • Delete every column you will not be updating (except Type, Email, and the fields you plan to update.
  • Make your updates. Remember, you will not be able to update email or type.
  • You will also not be able to enter grades that do not already exist in your myblueboard account.
  • If you are using a Mac, the file may open in the Numbers program. You can make updates in this program, but you must save the file as follows: File > Export as > .csv.


3) Upload CSV to mybb

  • Navigate back to the Admin Tasks page.
  • Select the Choose File button from the Import Accounts box.
  • Upload your updated .csv file.
  • Click the Import button.
  • If successful, you will see a popup that says the number of changes that have been made.
  • If you encounter an error, you will receive a notification about where the error can be found.
  • Fix the error, follow the same process and save the file as a .csv again.
  • Upload the new, corrected file and click Import.

Mass Uploading New Accounts

Where do I start?

  • If you are creating new accounts for your students, parents, and/or directors, then you can start by using this Excel import builder file.
  • The builder will help you enter your data to ensure a smooth import process (Image 3).
  • If you hover over the titles in Row 3, helpful information for each column will populate.


How do I use the import builder file?

  • Enter all your data into the import builder.
  • Review which columns are required and optional.
  • IMPORTANT TIPS:
  • Don't worry about getting all your data into the import builder. You can always update fields individually in the app or perform a mass update at a later date.
  • Most organizations only complete the required fields for the initial onboarding.


  • Required columns
  • Required columns for every account type:
  • type, email, first_name, last_name
  • Additional required columns for student accounts:
  • grade and section
  • Additional required columns for director accounts:
  • title and prefix
  • Optional columns
  • Columns E-I are optional fields for Students and Parents.
  • Columns J-K are optional for Student, Parent, or Director accounts.
  • Columns L (grade) and M (section) are required fields for Student Accounts.
  • If you don't know the section, you can write "unknown".
  • Columns N-U are additional optional fields for Students.


What do I do after I enter my data in the import builder?

  • Save the Excel file.


  • Step 1: Copy data to new file and save as CSV
  • Once you have completed entering the data, copy the entire table except for Rows 1 and 2.
  • Go to File > New to open a new spreadsheet.
  • In the first column of the first row, right click and Paste and your data will populate in the new file.
  • Save your file as CSV UTF-8 (Comma delimited) (.csv) or Comma Separated Values (.csv).


  • Step 2: Upload CSV file to mybb
  • Navigate back to the Admin Tasks page in myblueboard.
  • In the Import Accounts box, select the Choose file button and upload your .csv file.
  • If there are any errors in your file, you will be prompted with the reason for the error.
  • Correct the errors in your file and resubmit.
  • When your import is successful, a popup will notify you of how many accounts and relationships were added (Image 6).
  • You can see all new accounts by navigating to the left sidebar > Accounts > Student Accounts (or Parent and Director).
  • Step 3: Inform everyone how they can login
  • Students and parents can access their accounts by using your custom mybb URL and selecting the Forgot Password button.
  • They will be prompted to enter an email to reset their password and they must enter the email you uploaded into myblueboard.
  • They will receive an email to reset their password and then they can login to their new account.



Excel Import Building Screenshots and Helpful Information


Type

  • Can only be Student, Parent, or Director.
  • You cannot add additional Types.


Multi-Value Fields

  • Some fields are have more than one value. These are called Multivalue Fields.
  • Multivalue Fields included in this builder are Student Groups, Parent Groups, Allergies, Food Allergies, OTC Medications, and Child Relation.
  • IMPORTANT NOTES:
  • Do not separate these values with commas.
  • You must use 3 hyphens with no spaces before or after multiple values.
  • Example:
  • For Student Groups, "Marching Band---Jazz Band---Concert Band " (Image 4).

Student Groups & Parent Groups

  • You can add any Group you choose and it will create the Group in your myblueboard app.
  • However, if there is a misspelling, it will create a new group and it is also case sensitive.
  • For example, if one of your group listings is Boosters, and you add boosters to someone else's group listing, it will create a new group for the all-lowercase boosters.


Student Connection Number

  • The Student Connection Number is used to connect Student and Parent Accounts.
  • In the example below (Image 5), you can see Lorcan Acevedo's Student Connection Number is 100. To connect his account to Aleena Acevedo, his mother, we enter his Student Connection number 100_mother in the Child Relation column for Aleena.
  • You must use an underscore with no spaces before or after.
  • Directors cannot connect their account to a student.
  • If the director has a child in myblueboard, we encourage them to make a separate Parent account with a personal email.


Import Accounts: successful import message


  • You can see all new accounts by navigating to the left sidebar > Accounts > Student Accounts (or Parent Accounts / Director Accounts).
  • Students and parents can access their accounts by using your custom myblueboard registration URL and selecting the Forgot Password button.
  • They will be prompted to enter an email to reset their password.
  • They must use the email you uploaded into myblueboard.
  • They will receive an email to reset their password and then they can then login to their new account.


Share by: