07. Best Practices for BeaverDash
This page collects recommended approaches for common BeaverDash design and layout decisions. Each recommendation explains the reasoning, not just the rule.
Build on Beaver Themer layouts, not individual pages
Design your course, lesson, topic, and quiz layouts as Beaver Themer singular templates, not as individual Beaver Builder pages. A Themer layout applies automatically to every matching post type — one layout covers every lesson on your site. Building a regular Beaver Builder page per course or lesson means duplicating that work every time you add content.
Create one layout per LearnDash content type: course singular, lesson singular, topic singular, quiz singular. Use BeaverDash modules and field connections inside these layouts to pull in the correct data for whichever specific page the learner is viewing.
Use field connections in Themer layouts, shortcodes in content areas
BeaverDash gives you two ways to embed LearnDash data. Field connections work inside Beaver Themer layouts and use the native Beaver Builder connection system. Shortcodes are WordPress shortcodes and work anywhere WordPress processes shortcodes — post content, module text fields, widgets, and PHP templates.
Use field connections when you are building a Themer layout. Use shortcodes when you are adding dynamic data to post content or a module text field. Mixing them up is the most common source of nothing-appearing issues: field connections produce no output outside of Themer, and shortcodes in a Themer connection field do not behave as expected.
Match the Mark Complete redirect to your course structure
The Mark Complete button sends learners somewhere after they click it. The right destination depends on your course design.
Set Redirect to Next when your course uses strict linear progression and you want learners to advance automatically to the next lesson or topic.
Set Redirect to Parent course when learners finish the last topic in a lesson and should return to the course overview rather than advancing deeper into the structure.
Set Redirect to Self on quiz pages where LearnDash needs to handle the quiz submission on the same page before any navigation happens.
The wrong redirect creates friction — learners land somewhere unexpected or navigate away before LearnDash has finished processing their completion.
Enable quiz visibility in navigation modules selectively
The Course Navigation, Lesson Navigation, and Topic Navigation modules all hide quiz items at every level by default. This is intentional: on courses with many quizzes, enabling all levels makes the outline dense and hard to scan.
Enable quiz visibility only at the level that is meaningful in context. On a topic-level template, enabling topic quizzes makes sense. Enabling all three levels in the Course Navigation module on a course with many lessons, topics, and quizzes per topic produces an outline that is longer than the content it is supposed to help learners navigate.
Set Expand to Current on long course outlines
The Course Navigation and Lesson Navigation modules default to expanding all sections. On courses with many lessons or topics, this produces a very long outline on every page.
Set Expand to Current to collapse completed sections and show only the active section open. Learners who want to jump to a different section can expand it manually. This keeps the navigation focused on where the learner is now rather than showing everything at once.
Use Limit Items for courses with strict progression
The Course Content Table and Lesson Content Table modules display all lessons or topics, including locked ones. On courses where strict progression is enforced, showing locked content to learners who cannot access it yet creates confusion.
Enable the Limit Items tab and set Availability to Available to show only the content the current learner can actually access. Use Progression to filter further to only items the learner can advance to next. This makes the table a useful map of what is accessible, not an inventory of everything that exists.
Set up Focus Mode in a staging environment
Focus Mode requires four things to work correctly: Beaver Builder, Beaver Themer, LearnDash 3.0+, and the Themer Extension: Focus Mode toggle enabled in settings. After enabling the toggle, you must build three Beaver Themer parts — Header, Sidebar, and Content — and assign them before learners see a working focus-mode view.
Set this up in a staging environment before enabling it on a live site. Enabling the toggle without the Themer parts in place produces a broken focus-mode layout for learners. Test with a real LearnDash course and verify on both desktop and mobile before going live.
For setup instructions, see Setting Up Focus Mode.