Migrating a LearnDash LMS site is one of the most complex WordPress migrations you can do. Moving pages and posts is easy. Moving courses is harder. Moving user progress correctly is the real challenge.

Many site owners discover this the hard way.

Courses appear on the new site, but user progress is broken. Some users are marked as completed when they are not. Others lose all progress. After multiple test imports, duplicate courses appear and everything becomes misaligned.

Why LearnDash Migrations Often Fail

LearnDash does not store progress in a simple or portable way. Progress is tightly linked to internal WordPress IDs. When those IDs change, progress data no longer points to the correct lessons, topics, or quizzes.

This creates a silent failure. The import looks successful, but progress is wrong.

Key Reasons Progress Does Not Carry Over

LearnDash progress issues usually happen because of the following reasons.

First, course, lesson, topic, and quiz IDs change during import. Even if the content looks identical, WordPress assigns new IDs.

Second, LearnDash stores progress in user meta and custom database tables that reference those IDs directly.

Third, repeated imports create duplicate courses. Progress may point to the old version, while users are viewing the new one.

Fourth, partial imports cause mismatches. Some lessons exist, others do not, breaking completion logic.

Because of this, LearnDash migrations cannot be treated like normal content migrations.

How LearnDash Stores Course and User Progress Data

To migrate correctly, you need to understand where the data lives.

LearnDash uses a combination of post types, user meta, and custom database tables.

Main LearnDash Data Locations

LearnDash relies on these core components.

Courses, lessons, topics, and quizzes are stored as WordPress custom post types.

User progress is stored in the wp_usermeta table, mainly under the meta key _sfwd-course_progress.

Quiz attempts and statistics are stored in custom LearnDash tables such as wp_ld_quiz_statistics.

Lesson and topic completion status references internal post IDs directly.

This means progress data is not portable unless IDs match.

Why ID Matching Is Critical

Every progress entry looks something like this conceptually.

User X completed lesson ID 123 in course ID 45.

If lesson ID 123 becomes lesson ID 987 on the new site, the progress entry is now invalid.

LearnDash does not automatically remap IDs during imports.

This is the core reason progress breaks.

Symptoms of a Broken LearnDash Migration

Most sites show the same warning signs after a failed migration.

• Courses appear multiple times in the admin area
• Users report missing or incorrect progress
• Lessons appear completed but topics inside are not
• Quizzes show attempts but do not unlock lessons
• Course completion certificates do not trigger

These issues usually get worse with each test import. At this point, continuing to import data will only make things harder to fix.

Why You Must Reset LearnDash Before Re-Migrating

If you already attempted multiple imports, the safest approach is not to patch the data.

The correct solution is a clean reset.

Trying to manually fix mismatched IDs after the fact is extremely time consuming and error prone.

A reset allows you to start with a known, clean state and migrate correctly from the beginning.

What Resetting LearnDash Means

Resetting LearnDash does not mean deleting WordPress.

It means removing LearnDash related content and progress data so that new imports do not conflict with old data.

A proper reset removes:

• All LearnDash courses, lessons, topics, and quizzes
• All LearnDash user progress metadata
• All LearnDash quiz statistics

This gives you a clean base to work from.

Safe LearnDash Reset Checklist

Before resetting anything, preparation is critical. A reset without preparation often causes more problems than it solves.

Never reset without backups.

Step 1: Full Backup

Create a full database and files backup. This ensures you can restore the site if something goes wrong or if data needs to be recovered later.

Step 2: Export the Old Site Data

On the old site, export all LearnDash related data before starting the reset process.

This should include:

• Courses, lessons, topics, and quizzes
• Users and user roles
• User progress data if available
• Quiz attempts if required for compliance or reporting

This exported data will be used later for a controlled and accurate migration.

How to Reset LearnDash on the New Site (Properly and Safely)

If your LearnDash migration already created duplicate courses or broken user progress, the safest solution is a full LearnDash reset on the new site.

This does not reset WordPress itself. It resets only LearnDash related content and data.

The goal is to remove all LearnDash objects and progress records so you can start a clean migration without ID conflicts.

Before starting, always create a full database backup. This step is not optional.

Step 1: Delete All LearnDash Content (Courses, Lessons, Quizzes)

LearnDash stores its content as WordPress custom post types. If these remain in the database, new imports will create duplicates and ID conflicts.

You must remove all LearnDash related post types completely.

What to delete in WordPress admin

Go to the WordPress dashboard and permanently delete the following post types:

1. Course
2. Lessons
3. Topics
4. Quizzes
5. Certificates

Delete them from their respective admin menus, not from the media library or standard pages.

Important detail: Empty the Trash

After deleting the items, go to the Trash and permanently delete them.

If LearnDash content remains in the trash, WordPress keeps their IDs reserved. This can cause unexpected conflicts during re-import.

At the end of this step, the new site should contain zero LearnDash courses or lessons.

Step 2: Remove LearnDash User Progress Data

Deleting courses alone is not enough.

LearnDash stores user progress separately in the WordPress user meta table. If this data remains, it will continue pointing to old course IDs that no longer exist.

This step removes all stored LearnDash progress for all users.

What this step does

It deletes:

1. Course completion status
2. Lesson and topic completion data
3. Progress percentages

It does not delete users, user roles, or non LearnDash data.

SQL query to remove LearnDash progress

Run the following query using phpMyAdmin, Adminer, or a similar database tool.

Always run this on a backup first.

DELETE FROM wp_usermeta
WHERE meta_key LIKE '%_sfwd-course_progress%';

Why this is necessary

LearnDash progress is stored as structured arrays under this meta key. If you import new courses with new IDs, old progress data becomes invalid and causes broken completion states.

After this step, all users will appear as having no course progress, which is exactly what you want before a clean migration.

Step 3: Clean LearnDash Quiz Data

Quiz attempts and statistics are not stored in standard WordPress tables. LearnDash uses its own custom database tables for this data.

If these tables are not cleared, quiz attempts may still exist but no longer match the new quizzes.

Common LearnDash quiz tables

Most LearnDash installations use these tables:

wp_ld_quiz_statistics
wp_ld_quiz_statistics_ref

Depending on your table prefix, they may appear differently. Always confirm the correct table names before running queries.

How to reset quiz data safely

Instead of deleting the tables, truncate them. This keeps the table structure intact while removing all stored data.

TRUNCATE TABLE wp_ld_quiz_statistics;
TRUNCATE TABLE wp_ld_quiz_statistics_ref;

What this removes

1. All quiz attempts
2. All quiz statistics
3. All historical quiz results

This does not affect course structure or users.

What You Should Have After the Reset

Once all three steps are completed, your LearnDash setup should be in a clean state.

You should see:

1. No courses, lessons, topics, or quizzes in admin
2. No user progress data
3. No quiz attempts or statistics

At this point, LearnDash behaves like a fresh installation, without reinstalling the plugin.

This is the correct and safest starting point for a proper migration.

Correct Migration Strategy for LearnDash

Now that you have a clean site, you can migrate properly.

The most important rule is simple.

Course structure must be imported before user progress.

Recommended Migration Order

1. Import courses, lessons, topics, and quizzes
2. Verify course structure and hierarchy
3. Lock course IDs
4. Import users
5. Remap and import user progress

Skipping or reordering these steps will cause issues.

Mapping Old IDs to New IDs

This is the most critical step.

You need a mapping table that links old site IDs to new site IDs.

This table allows you to translate old progress references to new ones.

Without this mapping, progress cannot be restored reliably.

Sample PHP Code for Progress Remapping

Below is a simplified example of updating progress using mapped IDs.

$user_id = 25;

$progress = get_user_meta($user_id, '_sfwd-course_progress', true);

foreach ($progress as $old_course_id => $course_data) {
    $new_course_id = $course_map[$old_course_id];
    $new_progress[$new_course_id] = array();

    foreach ($course_data['lessons'] as $old_lesson_id => $lesson_data) {
        $new_lesson_id = $lesson_map[$old_lesson_id];
        $new_progress[$new_course_id]['lessons'][$new_lesson_id] = $lesson_data;
    }
}

update_user_meta($user_id, '_sfwd-course_progress', $new_progress);

This logic must be adapted to your real data structure, but the concept remains the same.

Validating the Migration

After importing progress, validation is essential.

What to Test

Log in as test users.

Check lesson completion status.

Check topic progression.

Check quiz unlock behavior.

Check certificates and course completion.

Compare results against the old site.

If something is wrong, stop and fix it before continuing.

Common Mistakes to Avoid

Many LearnDash migrations fail because of avoidable mistakes.

Running imports multiple times on the same database.
Importing users before courses.
Ignoring ID mismatches.
Trying to manually fix progress in the admin UI.
Not testing with real users.

Each of these can cause silent data corruption.

When a Full Progress Migration Is Not Worth It

In some cases, restoring full progress is not practical.

For very old sites with inconsistent data, it may be better to reset progress intentionally, grant manual course completions, or offer users a restart or partial credit.

This decision should be based on business impact, not just technical feasibility.

SEO Considerations During LearnDash Migration

A broken LMS can also hurt SEO.

Ensure that:

Course URLs remain consistent or are redirected.
No duplicate courses are indexed.
Old course URLs redirect to new ones.
Sitemaps are regenerated.

Search engines should see one clean version of each course.

LearnDash migrations fail when they are treated like standard WordPress imports.

They succeed when they are treated like data migrations.

If your LMS is a core business asset, investing time in doing this correctly will save weeks of support issues later.

A clean migration is not about speed. It is about accuracy.

Learndash customization

Are you looking to take your e-learning platform to the next level? Look no further than Learndash customization. Learndash is a powerful learning management system (LMS) for educational institutions and businesses alike, and customizing it can provide a truly unique and tailored learning experience. In this article, we will explore the benefits and possibilities of Learndash customization, backed by real-world examples.

Customising Learndash allows you to align the platform with your brand, enhance user engagement, and create personalized learning journeys. Whether it’s applying your company’s branding, designing interactive elements, or integrating additional functionalities, Learndash customization empowers you to achieve your desired outcomes.

Throughout this article, we will delve into various examples of Learndash customization, showcasing how different organizations have successfully modified the platform to suit their specific needs. From custom-designed course layouts to seamless integration with other tools and plugins, these real-life cases will inspire you to make the most of Learndash’s flexibility.

Stay tuned as we uncover the world of Learndash customization and explore how it can revolutionize your e-learning experience.

Why customize Learndash?

Customising Learndash offers a range of benefits that can greatly enhance the e-learning experience for both learners and administrators. Let’s take a closer look at why customisation is worth considering.

First and foremost, customising Learndash allows you to align the platform with your brand. By incorporating your company’s logo, color scheme, and overall visual identity, you create a cohesive learning environment that reflects your brand’s values and aesthetics. This branding consistency not only enhances the overall user experience but also helps build trust and credibility with your learners.

Furthermore, Learndash customisation enables you to enhance user engagement. By adding interactive elements, such as gamification features, multimedia content, and social learning tools, you can make the learning experience more dynamic and enjoyable. Engaged learners are more likely to retain information and complete courses, leading to improved learning outcomes.

Another key advantage of customising Learndash is the ability to create personalised learning journeys. By tailoring the platform to suit individual learners’ needs, you can provide a more immersive and relevant learning experience. This can be achieved through adaptive learning paths, personalised course recommendations, and targeted assessments. Personalisation not only increases learner satisfaction but also improves knowledge retention and application.

In summary, customising Learndash offers the opportunity to align the platform with your brand, enhance user engagement, and create personalised learning journeys. Now, let’s explore some real-world examples of Learndash customisation to see these benefits in action.

Examples of Learndash customizations

Customising Learndash is a versatile process that can be tailored to meet the specific needs of your organisation. Let’s take a look at some real-world examples of Learndash customisations to get inspired.

Customizing the Learndash user interface

One way to customise Learndash is by modifying the user interface to match your brand’s visual identity. For example, Company X, a leading e-learning provider, customised Learndash to incorporate their logo, color scheme, and typography throughout the platform. This created a seamless and consistent experience for learners, reinforcing their brand and increasing learner engagement.

In addition to branding, you can also customise the user interface to improve usability. Company Y, a corporate training company, customised Learndash by simplifying the navigation and restructuring the course layout. They created a more intuitive and user-friendly interface, making it easier for learners to navigate through the content and track their progress.

Customizing Learndash course layouts

Customizing course layouts is another effective way to enhance the Learndash experience. Customizing Learndash by creating visually appealing and interactive course layouts. They incorporated multimedia elements, such as videos and interactive quizzes, to make the learning experience more engaging and immersive. This customisation not only increased learner satisfaction but also improved course completion rates.

Furthermore, you can customise Learndash course layouts to meet specific instructional design requirements. Company A, a healthcare training provider, customised Learndash to include custom progress trackers and interactive simulations. This allowed learners to track their progress in real-time and practice critical skills in a safe virtual environment. The custom course layouts provided a more realistic and hands-on learning experience.

Enhancing Learndash quizzes and assessments

Customising Learndash quizzes and assessments can greatly improve learner engagement and knowledge retention. Company B, an online certification provider, customised Learndash by adding gamification elements to their quizzes. They incorporated points, badges, and leaderboards to create a competitive and motivating learning environment. This customisation not only increased learner participation but also improved quiz performance and knowledge retention.

Another way to enhance Learndash quizzes and assessments is by incorporating multimedia elements. Company C, a professional development platform, customised Learndash by adding video-based assessments. This allowed learners to demonstrate their skills and knowledge through practical scenarios, providing a more authentic and comprehensive assessment experience.

Integrating third-party plugins with Learndash

Learndash can be further customised by integrating third-party plugins and tools. For example, Company D, an e-learning platform for IT professionals, customised Learndash by integrating a virtual lab environment. This allowed learners to practice their skills in a virtual sandbox, providing a hands-on learning experience. The seamless integration between Learndash and the virtual lab enhanced the overall learning experience and increased learner satisfaction.

Additionally, you can integrate Learndash with communication and collaboration tools to facilitate social learning. Company E, a corporate training provider, customised Learndash by integrating a discussion forum and live chat feature. This enabled learners to interact with each other, ask questions, and share insights, fostering a collaborative learning environment.

Advanced Learndash customization techniques

In addition to the examples mentioned above, there are advanced Learndash customization techniques that can further enhance the platform’s functionality. These techniques require technical expertise and can be tailored to meet specific requirements.

One advanced customization technique is creating custom user roles and permissions. This allows you to define different user roles, such as instructors, administrators, and learners, with specific permissions and access levels. This level of customization is particularly useful for large-scale e-learning platforms with multiple stakeholders and complex workflows.

Another advanced customization technique is integrating external APIs to extend Learndash’s capabilities. This allows you to connect Learndash with other systems and tools, such as CRM software or payment gateways. For example, Company F, an online course marketplace, customised Learndash by integrating with a CRM system to automate course enrollment and user management processes.

Best practices for Learndash customization

While Learndash customisation offers endless possibilities, it’s important to follow some best practices to ensure a smooth and successful customisation process. Here are some tips to keep in mind:

1. Plan ahead: Clearly define your customisation goals and requirements before starting the process. This will help you stay focused and avoid unnecessary modifications.
2. Test thoroughly: Before implementing any customisations, thoroughly test them in a staging environment to ensure compatibility and functionality.
3. Stay up to date: Regularly update your Learndash installation and any customisations to ensure compatibility with the latest version and security patches.
4. Document changes: Keep a record of all customisations made, including code modifications and plugin integrations. This will make it easier to troubleshoot any issues and maintain consistency.
5. Consider scalability: If you anticipate future growth or changes in your e-learning platform, consider customisations that are scalable and adaptable.

By following these best practices, you can ensure a successful and sustainable Learndash customisation process.

Conclusion

Customising Learndash can take your e-learning platform to new heights. Whether it’s aligning the platform with your brand, enhancing user engagement, or creating personalised learning journeys, Learndash customisation empowers you to create a unique and tailored learning experience. The real-world examples showcased in this article demonstrate the vast possibilities of Learndash customisation, from custom-designed course layouts to seamless integrations with other tools and plugins.

As you embark on your Learndash customisation journey, remember to plan ahead, test thoroughly, and stay up to date with updates and best practices. With careful customisation, Learndash can truly revolutionise your e-learning experience and drive better learning outcomes. So, go ahead and unleash the power of Learndash customisation to create a truly exceptional e-learning platform.