The Course List Block allows you to display and configure a list of courses anywhere on your site.
Add a Course List block
To add a Course List block, type /course in the block editor on any page or post, and select the Course List block.
Or you can click the ‘plus’ button and select the Course List block in the sidebar:
Choose a pattern
When you add the Course List block, you will be prompted to Choose a pattern for the query loop. This determines how your course list will be layed out.
Click ‘Choose’ and then select a pattern. Patterns available by default are Courses displayed in a list (the default layout on the My Courses page) and Courses displayed in a grid. You can also create your own patterns if you decide to build your own custom layout.
Once you select a pattern, you’ll see a preview of how your course list will be displayed.
You can open the Document Overview by clicking the 3 lines in the top-left toolbar to see all of the blocks that make up your Course List:
This course list (displayed in a grid) consists of a Course List Filter block, a Post Template block, and a Pagination block.
Course List Filter block
The Course List Filter block allows users to filter which courses are shown. You can customize this in the block sidebar to allow filtering by any combination of Course Categories, Featured status, and Student Courses (this determines whether to show All Courses, only the user’s Active courses, or only the user’s Completed courses.)
Post Template block
The Post Template block controls how each course in your list will be displayed. It consists of several other blocks, which can be rearranged or edited as needed. It also contains the Course Actions block, which displays the relevant actions a student can take depending on their enrollment/progress in each course.
Pagination block
The pagination block is what allows users to navigate between multiple pages of courses if you have too many courses in your list to fit on one page.
Course List block settings
If you select the top level Course List block in the Document Overview, you’ll see some settings for the block in the right sidebar.
Layout
The Layout settings allow you to control the content width and justification of the course list elements.
Order by
This determines whether your courses will be ordered by Oldest to Newest, Newest to Oldest, A to Z, or Z to A.
Posts per page
This controls how many courses will be displayed on each page of courses in your list.
Filters
Here you can further refine what courses are displayed, filtering by Course Category, Author, and Keyword.
Advanced
Various advanced settings.
Student Courses Block (Legacy)
Note that the Student Courses block is a legacy block and should not be used. It’s no longer available in the block inserter from Sensei LMS 4.25.0 and will be deprecated in a future release.
If your site still uses the Student Courses block, we recommend switching to the Course List block for greater flexibility and future compatibility.