Step-by-Step LearnDash Theme Tutorial for LMS and Community Websites

LearnDash handles the teaching logic (courses, lessons, quizzes, certificates) but leaves most of the presentation to your theme. Pick a theme that was never built for an LMS and you get course pages that look like blog posts, a student dashboard that is hard to find, and a community that lives on a different part of the site. This tutorial walks through choosing and setting up a LearnDash-ready theme, configuring the LearnDash settings that interact with it, and wiring in BuddyPress so courses and community share one layout.

We are writing this against LearnDash 5.1 (the 5.x branch shipped through 2025 and 2026) and WordPress 7.0. Menu paths reflect those versions.

What a theme has to get right for LearnDash

LearnDash ships its own templates for course, lesson, topic and quiz content, and since version 4.21 (March 2025) it also offers “Modern” course page layouts alongside the older 3.0 template. The theme wraps those templates. A good LearnDash theme does five things that a general-purpose theme does not:

• Course archive and grid. A catalog with filters for category, difficulty and price, and cards that show progress for enrolled learners. The default /courses/ archive in most themes is a plain post list.
• Lesson layout. A reading column of sensible width, a persistent course outline, and a “Mark Complete” button that is visible without scrolling. Sidebars full of widgets work against this.
• Student dashboard. Enrolled courses, progress, certificates and achievements in one place, with a link in the main navigation.
• Full-width and distraction-free support. LearnDash Focus Mode strips the theme header and footer; the theme should not fight it with fixed elements or global CSS.
• Community integration. If you run BuddyPress or BuddyBoss Platform alongside LearnDash, course activity should land in the activity feed and course groups should map to social groups without custom code.

If a theme demo only shows a pretty homepage and never a lesson page, assume it has not solved the hard parts.

Choosing a theme: three realistic paths

Path	Good for	Trade-off
Free community theme (BuddyX)	Getting started, tight budgets, BuddyPress + LearnDash sites	Fewer LearnDash layout options than the Pro versions; styling is mostly Customizer-based
Premium LMS + community theme (BuddyX Pro, Reign with the LearnDash add-on)	Sites that sell courses and run a community, need dashboards, dark mode, lesson layouts	Annual licence ($39 to $99 a year for the add-on, plus the theme)
Block theme + LearnDash Modern layouts	Developers comfortable with theme.json and the Site Editor, simple catalogs	You build the dashboard and community pages yourself

Our usual recommendation: if BuddyPress is part of the plan, start with BuddyX (free, supports LearnDash, LifterLMS, Tutor LMS and LearnPress out of the box) and upgrade to Pro when you need the extra layouts. If you want the most control over every LearnDash surface (course grid, lesson sidebar, quiz screens, certificates, dark mode), Reign plus the Reign LearnDash add-on themes all of them and posts course events into the BuddyPress feed. A block theme is a fine choice for a catalog-only site with no community.

Step 1: Install the theme and demo content

1. Install LearnDash first (Plugins → Add New → Upload Plugin), then activate your licence under LearnDash LMS → Settings → LMS License.
2. Install the theme under Appearance → Themes → Add New. For BuddyX, search “BuddyX” in the directory; for Reign, upload the zip from your account.
3. Run the demo importer if the theme has one. BuddyX ships four starter packs under Appearance → BuddyX → Demo Import; pick the LMS or community pack. Demo content gives you working menus, a dashboard page and sample courses you can replace.
4. Install the companion plugins the importer asks for. For an LMS site the relevant ones are usually BuddyPress (or BuddyBoss Platform), the theme’s add-on for LearnDash, and a page builder only if you plan to use it.

Do this on a fresh install or staging site. Importing demo content into a site that already has pages creates duplicates you will be cleaning up for a week.

Step 2: Configure the LearnDash settings that affect layout

These settings live under LearnDash LMS → Settings and decide what the theme has to style.

Active template

LearnDash LMS → Settings → General → Design & Content Elements. Choose the LearnDash 3.0 template (the Legacy template is unsupported by modern themes and by Focus Mode). If you are on 4.21 or later you will also see Modern course page layouts; enable them if your theme states support, and leave them off if you use a third-party styling plugin, since several of those do not yet work with the Modern layouts.

Focus Mode

Same screen, Focus Mode section. Enabling it gives lessons, topics and quizzes a distraction-free layout with the course outline on one side and no theme header or footer. Options worth setting:

• Logo: upload a version of your logo for the Focus Mode header.
• Content width: Default 960px suits text-heavy courses; Wide (1180px) or Extra-wide (1600px) suits video-first courses.
• Sidebar position: left or right (available since LearnDash 4.1).
• Focus Mode menu: create a small menu under Appearance → Menus and assign it to “LearnDash: Focus Mode Dropdown” so students can reach their profile and support without leaving the course.

Focus Mode only applies to lessons, topics, quizzes and assignments. Course pages still use your theme, which is why the theme’s course layout matters.

Course grid

The Course Grid add-on (included with LearnDash) provides the Course Grid block and the [ld_course_list] shortcode. BuddyX and Reign style the grid cards; if you use a separate design plugin, check whether it supports the block or needs the shortcode. Set columns to three on desktop, and make sure “Show progress bar” is on so enrolled learners see where they are.

Permalinks

LearnDash LMS → Settings → Permalinks. Change the default sfwd-courses slug to courses and sfwd-lessons to lessons before you publish anything. Changing it later breaks links in emails and certificates.

Step 3: Set up the theme’s LearnDash options

In BuddyX, go to Appearance → Customize → LearnDash (BuddyX Pro adds more options here). In Reign with the LearnDash add-on, the controls sit under Appearance → Customize → Reign LearnDash. Across both, the decisions that matter are:

1. Course archive layout: grid or list, columns, and which meta to show on the card (price, lesson count, duration, instructor).
2. Single course layout: whether the enrol button and progress sit in a sticky sidebar (our preference; it keeps the call to action visible) or inline above the content.
3. Lesson layout: with or without the theme sidebar when Focus Mode is off. Turn the widget sidebar off on lessons; nobody wants “Recent Posts” next to a quiz.
4. Dashboard: BuddyX and Reign add LearnDash tabs to the BuddyPress member profile (Courses, Certificates, Achievements). Set the profile as the dashboard destination in your main menu rather than building a separate dashboard page. If you need more than profile tabs, our Dashboard for LearnDash adds a front-end builder for instructor and student dashboards plus admin reports.
5. Dark mode: Reign’s add-on ships a full dark palette for LearnDash surfaces. Enable it with a toggle in the header if your audience studies in the evening.

Step 4: Connect courses to the community

This is the part most LearnDash sites skip, and it is the part that drives completion. A course with a group behind it finishes at a noticeably higher rate than a course students take alone.

1. Activate BuddyPress and enable Activity Streams, User Groups and Extended Profiles under Settings → BuddyPress → Components.
2. In LearnDash, create a LearnDash Group for each course (LearnDash LMS → Groups) and associate the course under Group Settings → Courses.
3. Install a sync plugin so LearnDash group membership creates BuddyPress group membership. BuddyX, Reign and the LearnDash add-on handle this, as does our free BuddyPress LearnDash integration. Enrolment then auto-joins the student to the social group.
4. Turn on activity posting for course events (enrolled, completed lesson, passed quiz, earned certificate). In Reign’s add-on this is under Reign LearnDash → Activity; keep it to enrolment, completion and certificates, or the feed fills with “completed topic 3 of 42” noise.
5. Add a course-specific discussion space. Per-lesson discussion threads (the Reign add-on uses BuddyPress comments; LearnDash’s own lesson comments also work) keep questions next to the content they are about.

Step 5: Test the pages students actually use

Before launch, log in as a test student (not an admin; admins see everything) and walk through these in order, on a phone as well as a desktop:

• Course catalog: filters work, cards show the price, the enrol button leads to checkout.
• Single course: progress bar updates after you complete a lesson.
• Lesson in Focus Mode: logo, outline, Mark Complete, next-lesson navigation. Check that no theme element (cookie bar, sticky header, chat widget) overlaps the outline.
• Quiz: question layout, the results screen, and certificate download.
• Profile: Courses, Certificates and Achievements tabs appear and populate.
• Activity feed: the enrolment post appears and links back to the course.

Most problems you find here are CSS conflicts between the theme, a page builder and LearnDash. Switching the page builder off on lesson templates fixes the majority of them.

Common problems and fixes

Focus Mode shows the theme header anyway

You are on the Legacy template, or a plugin is forcing its header via a template hook. Switch to the LearnDash 3.0 template first; if it persists, deactivate header-related plugins one at a time.

Course grid cards are unstyled

The Course Grid add-on is disabled (LearnDash LMS → Add-ons), or you are using a design plugin that supports only the shortcode. Switch the block for [ld_course_list col="3" progress_bar="true"].

Students cannot find their courses

Add a “My Courses” item to the main menu pointing at the BuddyPress profile Courses tab (or your dashboard page), and set LearnDash LMS → Settings → Registration/Login → Login redirect to the same place.

Lesson pages are slow

Focus Mode pages with long course outlines run a query per lesson for progress. Object caching (Redis or Memcached) and LearnDash’s own “Course Navigation” pagination setting under the Focus Mode section both help. Keep lessons per course under 50 or split into sections.

Frequently asked questions

Can I use any WordPress theme with LearnDash?

Technically yes. LearnDash will render inside any theme. The result usually needs hours of CSS work and still lacks a dashboard and community layer, which is why LMS-specific themes exist.

BuddyX or Reign for a course site?

BuddyX if you want a free start and a lighter, Customizer-driven setup. Reign with the LearnDash add-on if you want every LearnDash surface themed, dark mode and per-lesson discussions, and you are fine paying for it. Both support BuddyPress and BuddyBoss Platform.

Do I need BuddyPress?

No. Both themes work with LearnDash alone. You need it if you want group discussions, member profiles as the student dashboard, and course activity in a feed.

Will a theme change affect my course data?

No. Courses, enrolments and progress live in the database independently of the theme. You can switch themes freely; only the presentation changes.

Where to start

Install LearnDash, then BuddyX, import the LMS demo, and switch on Focus Mode with the 3.0 template. That gets you a workable course site in an afternoon. Add BuddyPress and group sync once the first course is published, and upgrade to Reign or BuddyX Pro when you find yourself wanting more control over the lesson and dashboard layouts. If you would rather have it built, our LearnDash development team sets up exactly this stack for course businesses every month.