Skip to main content
pdf?stylesheet=default
Blackboard Help

Memberships File

Once you have created your Users and Courses files, create the Memberships file. Include field names and values that correspond to customizations made in the Properties file.

To Create the Memberships File

  1. Open Microsoft Excel or your preferred text editor to create the file using the appropriate encoding format.
  2. In the first line, enter the required field names, along with the other field names you wish to define.
  3. In subsequent lines, add the required field values and any optional values using the table below.
  4. Save the file and name it memberships.csv.

Example:
external_course_key,user_name,role
course_1,jsmith,student
org_1,ejones,instructor

Field Name

Description

Required

Accepted Value(s)

external_course_key

Corresponds to an external_course_key value in the course.csv file. If this field is blank or not in the Courses file, use the relevant course_id.

yes

Maximum of 255 characters; must match an entry in the Courses file

user_name

Corresponds to a user_name value in the users.csv file.

yes

Max of 255 characters; must match an entry in the Users file

role

Determines a person’s course membership role.

By default, this is set to: student.

no

student, ta, instructor;
a custom value defined in membership_role_mapping
in the Properties file

available

Determines whether or not a user’s membership in a course is available. Unavailable memberships are still synchronized so that they can be made available at any time.

By default, this is set to: Y.

no

Y, N
True, false
Yes, no
1 (true), 0 (false)