The easiest way to create a customized course is by using the Learn for Jira editor.

To start creating a course, click Create Content > Create Course > Create from the Content Management page.

You then need to fill in information for this course:

  1. First enter a new Name for your course. Be descriptive but concise.

    Learn for Jira lets you repeat course names. Think carefully before you decide to do this, as it may be confusing for your users.

  2. Enter a Description. This is optional, but encouraged, especially if you have several courses with similar names.

  3. Version is another optional, plain-text field that you can use for a number, or to give more alpha-numeric information.

  4. Duration is how long you would expect a user to need to complete the course. You can change this field later if needed, so don’t worry if you put in a guesstimate.

  5. If you add a group to Course Visibility, you are restricting access to the course for that group only. You can add multiple groups to this field. When this field is left blank, all users who can interact with Learn for Jira can see the course.

  6. If you add a group to Course Edit Permission, you are restricting the ability to edit the course to the users in that group with course editing permission. You can add multiple groups to this field. When this field is left blank, any user who has course editing permission can edit the course.

  7. When you are finished, click Create.

    An example configuration for a Create New Course screen.

When you are creating a course you are taken directly to your first chapter page. From here you can do several important things: Edit your chapter details, add modules to your chapter, and add more chapters. You can also go back and edit the course information if you need.

Edit chapter details

This one is a little tricky. On your first chapter and when you add a new chapter you need to go in and edit your chapter details. (If you don’t, all your chapters will be called "New Chapter.")

To edit your chapter details, click the ellipses menu by the chapter number on the Chapter tab, then click Edit.
The Ellipses (...) menu for a chapter, on the Content Management screen.

On the Edit Chapter page, enter a Name for your chapter. Then fill out the rest of the fields as desired. Even if you don’t want to write a description, delete the prompt text in the Description field box. When you are ready, click Update and you are taken back to the course page.

Add modules to a chapter

On each chapter tab, you need to add the modules you want that chapter to cover.

In order for you to add a new module to a chapter you need to have already created that module.

To add a module, start typing in the box. This search requires full words, so you need to type complete words. By way of example, "perm" won’t return any modules, but "permission" will. The search looks at both a module’s title and description, even though you cannot see the description in the results.

You can add as many chapters with as many modules as you like.

Because modules are shared between courses, progress on a particular module is tracked for all courses that module is in. It would therefore be possible to have never started a course but be finished with a portion of it already.

All changes are saved as you make them, so when you are happy with the content of your course, click Close. You can then view your new course at the bottom of the Course Viewer page.