Import permissions

You can import permissions from a .csv or .txt file and apply them to an existing role. This enables you to copy permissions from another organization, restore permissions previously exported, and import permissions created manually in a .csv or .txt file.

  1. From the Admin Tools menu, click Roles and Permissions.
  2. Click Import/Export.
  3. Select Import role permissions from a CSV or TXT file.
  4. Click Next.
  5. From the Import permissions for the role drop-down list, select a role.
  6. Click Next.
  7. In the Import File area, click Browse. Locate your .csv or .txt file. Click Open.
  8. Click Next > Import.

Import file format

Each row in the .csv or .txt file contains the value for a single permission. Rows follow the format [tool name], [permission name], [org unit type], [value].

All values should be enclosed in double quotation marks.

Comments can be inserted into the file by beginning a line with a double slash (//). Empty lines are ignored.



Tool name

The name of the tool the permission belongs to, as listed on the Edit Role Permissions page. For example, Blog, Competencies, or Manage Courses.

Permission name

The name of the permission, as listed on the Edit Role Permissions page. For example, See Updates Widget.

Org unit type

The name of the type of org unit where the permissions are applied, as listed on the Edit Role Permissions page. For example, Course Offering, Organization.


Indicates whether the permission is enabled (indicated by Yes, Y, 1, or True) or disabled (indicated by No, N, 0, or False)


For example:

// This file gives a role permission to create public blog entries

// and receive notification on comments, but not create an RSS feed

"Blog","See the Blog tool","Organization","Yes"

"Blog","Add / edit / delete Blog entries","Organization","Yes"

"Blog","Create public blog entries","Organization","Yes"

"Blog","Make Blog Externally Available","Organization","Yes"

"Blog","Receive email notification on comments","Organization","Yes"

"Blog","Publish blog as an RSS feed","Organization","No"