Skip to main content
pdf?stylesheet=default
Blackboard Help

Users File

Once you have saved your Properties file, you can create the Users file. This contains information about the people at your institution. Include field names and values that correspond to customizations made in the Properties file.

To Create the Users 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 users.csv.

Example:
user_name,first_name,last_name,email,available,institution_role
jsmith,John,Smith,jsmith@example.com,Y,none
ejones,Eve,Jones,ejones@example.com,Y,admin

Field Name

Description

Required

Accepted Value(s)

user_name

This corresponds to a person’s system account at your institution and is used to suggest a Blackboard IM ID during registration; each user sees this value when reviewing their Blackboard IM settings.

yes

Maximum of 255 characters

first_name

The person’s first name.

yes

Maximum of 255 characters

last_name

The person’s last name (surname).

yes

Maximum of 255 characters

middle_name

The person’s middle name.

no

Maximum of 255 characters

email

The person’s email address, which must follow standard conventions.
This field is required for Blackboard IM email invitations.
Example: yarly@example.com

no

An email address;
maximum of 255 characters

available

Determines whether or not a person's account is available on the Blackboard IM server. Unavailable user data is still synchronized so that accounts 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)

institution_role

Determines whether or not a person becomes a Blackboard IM Administrator; all other institution roles receive Student status.

By default, this is set to: none (Student).

no

admin, none;
a custom value defined in institution_role_mapping
in the Properties file