Upgrade from version 5.1.0
Reign LearnDash Addon overviewPremiumGet Reign LearnDash Addon →
Also called: update from old version, migrate settings, 5.1.0 to 5.2.0, shortcodes renamed, old reviews, upgrade stuck, LearnMate, wp reign-ld upgrade
What this does
Section titled “What this does”Version 5.2.0 is a rebuild. A one-time upgrade moves your saved data so nothing is lost. It then removes the old copies.
The upgrade starts by itself and works in small batches.
- Update the add-on to 5.2.0.
- Open any admin page as an administrator. The upgrade runs for a few seconds at a time.
- If no administrator visits, WP-Cron finishes it in the background.
- On a large site, run
wp reign-ld upgradeto do it all at once.
While it runs, an admin notice on the Dashboard, Plugins and Updates screens says so.
You’ll know it worked when
Section titled “You’ll know it worked when”The next of those screens shows a one-time notice that lists what moved. The same lines stay in the Update status card under Reign Settings > Integrations, then Configure on the LearnDash tile.
Good to know
Section titled “Good to know”What moves?
Section titled “What moves?”| Step | What happens |
|---|---|
| Settings | Old course page, archive and card settings move to the new fields. Sites that used the 5.1.0 course page get the Classic template, so the page looks the same. |
| Archive layout | Layout One becomes Classic cards. Layout Two becomes Reign default. Layout Three becomes Soft cards. |
| Sections and cards | The old hide switches become unticked boxes under Sections, Cards show and Filter bar. Hide Read More button unticks Cards show > Button. |
| Focus mode | “Modern” focus mode becomes the Focus mode extras switch. |
| Shortcodes | [reign_courses] becomes [modern_courses] in posts, pages, Elementor data and text, HTML and block widgets. Until that runs, the old name still shows the grid, so visitors never see raw shortcode text. |
| Reviews | Each 5.1.0 review becomes a LearnDash review with the same status, rating, title, author, date and text. Replies follow. |
| Review switch | Courses show or hide reviews the way 5.1.0 did. LearnDash’s per-course setting now controls this. |
| Community | Group and activity settings move to the new Community cards. Social group links are kept. |
| Default images | A default cover or course image that pointed at a placeholder 5.2.0 no longer ships is cleared, so the theme placeholder shows. Images from your media library are never touched. |
| Clean-up | Old flags and per-course layout values are no longer read. Post meta is kept under a _reign_ld_510_ prefix, not deleted. Permalinks are rebuilt. |
Can I undo the shortcode rename?
Section titled “Can I undo the shortcode rename?”Yes. The content as it was is kept. Run wp reign-ld upgrade --revert-shortcodes to put back every post, revision and Elementor value not edited since the update.
What does not move?
Section titled “What does not move?”- Group reviews. LearnDash reviews courses only. Saved group reviews stay as ordinary comments. The Update status card gives the count.
- LearnDash group links with the switch off. 5.1.0 could store a link nobody chose. The upgrade removes those links and keeps their ids under a
_reign_ld_510_prefix. Members and groups are not touched. - Activity message texts. 5.1.0 never used them.
- Settings with no 5.2.0 use. Curriculum layout, profile layout, the old distraction-free options and the dashboard text are removed. LearnDash has its own settings for these.
What about templates I copied into my theme?
Section titled “What about templates I copied into my theme?”If you copied 5.1.0 or LearnMate templates into your theme, they no longer load. See Template overrides for the new folder and the outdated-override check.
What about code that used the old hooks?
Section titled “What about code that used the old hooks?”5.1.0 class names, learnmate_* filters and review hooks are removed. See Hooks and filters.
The upgrade seems stuck. What do I do?
Section titled “The upgrade seems stuck. What do I do?”Run wp reign-ld upgrade. Without WP-CLI, open any admin page as an administrator and wait a few seconds.

