Learn for Jira Server and DC

Content Management

To create a course, create a module, or upload a course to Learn for Jira, first select Course Editor from the Lighthouse drop-down menu at the top-right of Jira, then click the Create Content button in the banner on the Content Management page.

You can only access the Content Management page if you have 'Course Create' or 'Course Admin' permissions.
Image highlighting the Create Content Button in the banner.

From there you have three options:

  • Create Course

  • Create Module

  • Upload Course.

Create Module

For most module types, content is stored outside of Jira and referenced by URL. When creating a module, you will set its name and description, select a template, enter a duration, and set a URL for the content.

It is important to select the correct template because that will determine how the content is displayed. Templates include:

  • YouTube

  • Vimeo

  • PDF

  • IFrame

  • Typeform

Example image with fields filled in
The module’s name and description are used in Learn for Jira’s search, so be sure to make them clear and concise.

You can also restrict visibility and editing permissions when creating or editing a module. These permissions use Jira groups.

Create Course

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.
  1. Next, enter a Description. This is optional, but encouraged, especially if you have several courses with similar names.

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

  3. Duration, of course, 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.

  4. 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.

  5. 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.

  6. When you are finished, click Create.

Example image with fields filled in

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.

Image showing the ellipses menu dropdown options.

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 its 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.

Upload Course

To upload a course, click Create Content > Upload Course > Create from the Content Management page.

A file dialogue box appears. Make your selection and click Open. You are returned to the Content Management page, and if you refresh the page you can see your new course added to the bottom of the page.

Courses must be JSON files with a specific set of attributes. You can download an existing course through the course’s edit screen and use that course JSON as an example for creating your own custom JSON courses.

Each course has a unique contentId. If you upload a course with the same contentId as a course that is already in Learn for Jira, the course you are uploading will overwrite the course that is already there, without any sort of warning alerts.
Roadmap and Suggestions