Skip to content

Display Course Categories

Use [reign_course_categories] to show a responsive grid of Tutor LMS course categories, each linking to its category archive.

[reign_course_categories]

This shows up to eight categories in four columns, ordered by name, hiding empty categories, with the course count and category image shown.

[reign_course_categories count="6" columns="3" orderby="count" order="DESC"]
  • count - how many categories to show (default 8).
  • columns - grid columns: 1, 2, 3, 4, or 6 (default 4).
  • orderby - name or count (default name).
  • order - ASC or DESC (default ASC).
  • hide_empty - yes hides categories with no courses (default yes).
  • show_count - yes shows the course count under each category (default yes).
  • show_image - yes shows the category thumbnail, or a placeholder when none is set (default yes).

If a category has a thumbnail_id term image, it is shown. Categories without one get a gradient placeholder so the grid stays even.

Setting count="0" used to mean “load every category”, which is unsafe on a site with thousands of categories. The addon now bounds an unlimited request to a maximum (100 by default), which you can change with the reign_course_categories_max filter. The default count of 8 and any positive count you set are unaffected. See Hooks and filters.

For the full reference, see reign_course_categories.