Don't See What You're Looking For?

Help Us Improve

Browse by Collection

Skip to end of metadata
Go to start of metadata


Blackboard Groups allow you to organize students for team-based learning or projects. Instructors can also use groups to organize the grade center and create smart views, or to set up adaptive release criteria for controlling content in the course. Students can be added to groups manually or randomly, or they can self-enroll. Some instructors may prefer to batch import students into groups if they have larger sections. 

Batch importing students to groups requires two key steps: Preparing the CSV file and uploading the CSV file to the Blackboard course. Groups must be created before students can be added to the groups. See → Creating Course Groups in Blackboard.


  1. Batch importing students to groups requires the Group Code used by Blackboard for each group. Follow the instructions below for Original and Ultra to identify the Group Code.
  2. Download and format the CSV template from the top of this page or here → sample_groupmembers.csv
    • If you open this CSV file in Excel, please be sure to save it as CSV.
    • If you need headings while you work on the file, the first column is Group Code and the second column is Username. Both columns are required. 
    • These headings should be removed when you save your CSV file and upload it to Blackboard.


The student must be enrolled in your course before the student can be added to a group. You must use the student's username to batch import through this process. Although PeopleSoft does not include the student's username, you can cross-reference the Campus ID through the "student ID" column in the Blackboard grade center, which also includes the student's username.

Bb RosterBb Grade CenterPeopleSoft Roster


Campus ID (listed under Student ID)

Campus ID

Tell Me: Original 

  1. Go to Control Panel → Users and Groups → Groups.
  2. Select View Options -> Show Group Code. 
  3. A new column will appear at the far right with the Group Code. 
  4. If the group code is blank, then you may need to Export a group first to generate a Group Code by the system.

Tell Me: Ultra

  1. Navigate to the left Course menu.
  2. Click on View sets & groups
  3. In Ultra, the Group Code is the name of the Group Set. Your Group Set cannot have any spaces so you must use an underscore between words (e.g., "Sports_Club" instead of "Sports Club").


  1. After the file is prepared, go to the course and select the Control Panel.
  2. Click Users and Groups -> Groups.
  3. Click on Import.

  4. Browse for the CSV file.

  5. Select the tools, if any, you would like to make available to the imported students in these groups. 
    TIP: If the groups are hidden and you intend to use the imported members only for grade center organization, uncheck all of the boxes.

  6. Click SUBMIT.

You should receive an email when your membership list has been processed.


  1. After the file is prepared, go to the course and navigate to Books & Tools on the left menu.

  2. Open the Books & Tools peek panel.
  3. Scroll down and click on UWM Groups Tool.

    A peek panel will open from the right. 
    The overview will show history of previous runs of the Groups & Group Enrollments for the given course. You can use the Refresh button to check for updated processing of uploads currently in progress.

  4. Click on Upload Group Enrollments.

  5. A peek panel opens where you can upload your CSV for Group Enrollments.
  6. Upload your CSV file.

  7. Click on SUBMIT.
  8. The file is processed in the background and added to the overview page.

You should receive an email when your membership list has been processed.


Although User Workflow Manager (UWM) tool for groups is available primarily for Ultra courses, it can be used with groups in Original courses. Access it via Control Panel → Course Tools → UWM Groups Tool. 

This tool can be performed by any Instructor, Course Builder, or Teaching Assistant enrolled in the course.

Rate this Article

Feedback: Correct or Suggest an Article | Request Help