Adding Modules

Sensei Modules Overview

Sensei Modules adds an additional level of organization to your Sensei content between Courses and Lessons. A Course can contain any number of Modules, and each Lesson can be assigned to a single Module within that Course.

Modules are only provided for organizational purposes; they don’t contain any content other than an optional text description.

Adding Modules

To add a Module:

  1. Go to Courses > Modules.
  2. Under Add New Module, give the Module a Name.
  3. Under Course(s), search for and select one or more Courses that will use this Module.

If you prefer, you can leave the Course(s) field blank and assign modules to courses later from the course edit screen.

Adding a Module
Adding a Module

Modules can be used by multiple Courses. e.g., You may have a piano course and a guitar course, both of which use the Basics module. The Module is a container for a group of lessons in each course, so the lessons in the Module are unique to each course.

Adding Modules from within a Course

Alternatively, you can add Modules from within a Course Edit page when creating/editing a Course.

  1. Go to Courses > All Courses.
  2. Click Add New, or edit an existing Course. You will see a Modules panel in the sidebar.
  3. Select any existing Modules you want to add to this Course.
  4. And/or click Add New Module, enter a Module name, and click the Add New Module button.
Modules Panel
Adding a Module from within a Course

Assigning Lessons to Modules

Once you have added some Modules to a Course, you can then assign each of the Course’s Lessons to any of the Modules used in that Course.

To assign a Lesson to a Module:

  1. Go to Lessons > All Lessons, and edit the Lesson in question. You will see a new Lesson Module panel in the sidebar, listing all the Modules available in this Course.
  2. Select the Module you want to assign this Lesson to.
  3. Update the Lesson.
Lesson Module
Assigning a Lesson to a Module

Ordering Modules

By default, any modules you add to a course will be displayed in alphabetical order. To reorder your Modules, go to Courses > Order Modules, select the course you want to edit, and simply drag and drop the modules into your desired order and click save.

Drag and drop to reorder modules
Drag and drop to reorder modules

Module Display

If a Course contains Modules, they will be displayed on the Single Course page, under the Modules heading, with each Module displaying a link to the Single Module page, and a list of links to the Lessons within that Module.

Screen Shot 2016-03-07 at 15.32.41


After a user has completed one or more of the lessons in a module, they will see an ‘In progress’ indicator for that module on the Module page, and the Course page.

After a  user has completed all the lessons in a module, they will see a ‘Completed’ indicator for that module on the Module page and the Course page.

Any Lessons not assigned to Modules will be displayed below, under the Other Lessons heading.

Adding Courses

Ready to create your first course? Then let’s get started!

To add a course, go to Courses All Courses and click Add New.

Start by giving the course a title:

Course title

Next, enter the content for the course page in the main content area. This content should describe the course and explain what learners can expect to learn. It can contain any type of content you like, including images, videos and HTML:

Course content

If you like, you can enter a brief description of the course in the Excerpt field:

Course excerpt

Add Categories

A course can be assigned one or more categories. You can select an existing category or click the Add New Course Category link to create a new one:

Course categories

Set a Course Prerequisite

If you would like learners to complete another course before taking this one, you can set a Course Prerequisite. Learners will not be able to start taking this course until they complete the prerequisite course first:

Course prerequisite

Feature a Course

To feature a course, select the Feature this course box. The course will then be displayed under Featured Courses on the course archive page and in the course component widget:

Featured course

Add a Featured Image

A featured image can be added to a course by uploading an image from your computer or selecting an existing image from the Media Library. The image displays on the course archive and single course pages, depending on the settings configured in Sensei > Settings > Courses:

Featured image

Add a Course Video

To add a video to the course page, paste the video embed code (from YouTube, Vimeo etc.) into the Course Video field:

Course video

The video displays for both users who are taking the course and those who are not. If you prefer to display it for only those users who are actually taking the course, you can embed the video into the main page content instead of in the Course Video field.

Disable Email Notifications

There is a Course Notifications panel on the course edit screen that gives you the option to disable all email notifications for just that course. This option overrides the global email options in Sensei > Settings > Email Notifications:

Course notifications

Add Lessons to a Course

See Adding Lessons for more information.

Edit a Course

Once your course is published and people have started taking it, we recommend against making major changes such as adding or removing lessons, editing quizzes etc. Doing so will affect the grades and completion status of users who are already taking (or have already completed) the course. Minor text edits are fine, but anything that will affect the overall completion status should be avoided.

If you decide that your course needs an update with extra lessons, different quizzes etc., the best solution would be to either create a new version of the course from scratch, or to duplicate the existing course and make the required updates before publishing.

Change Course Order

To change the order in which your courses are displayed, go to Courses > Order Courses. Then drag and drop the courses into the desired order, and click Save Course Order.

Latest versions of Sensei introduced a new Course Archive page, which displays courses in date order by default (newest first), and provides filters for the viewer to display “All, Featured, Free or Paid” courses, as well as changing the order to sort by title (A-Z). On this page, you cannot specify a custom order for courses. If you want to do that, you’ll need to create a custom Courses page, with the [sensei_courses] shortcode, and specify "menu_order" as the orderby value:

[sensei_courses orderby="menu_order"]

This will display your courses in the order specified in Courses > Order Courses.

Duplicate a Course

  1. Go to Courses > All Courses.
  2. Hover over a course and click the Duplicate link to duplicate it, or Duplicate (with lessons) to duplicate the course and all of its lessons.

What’s Next?

You may want to create some modules in order to group similar lessons together.

You can also read about how to sell your courses with WooCommerce.