Skip to main content

09. Troubleshooting

Common issues and their fixes, roughly in the order you'd meet them. If your issue isn't here, submit a support ticket.

The settings page shows a dependency notice instead of features​

Tangible Tweaks for LearnDash requires LearnDash. If LearnDash isn't installed and active, the plugin stays dormant and its settings page only shows the requirement. Install and activate LearnDash, then reload Settings > Tweaks for LearnDash.

I enabled a feature but nothing changed​

  • Confirm you clicked Save Changes after ticking the feature.
  • Most features act somewhere specific: a lesson's settings, a shortcode you place, an admin screen. Check the feature's page in Basic Usage for where to look.
  • Features that change learner behaviour (drip, independent completion) are best verified from a learner account. Administrators often bypass course restrictions.

The Gravity Form picker is empty​

The Gravity Form for Lesson/Topic Completion field lists the forms that exist in Gravity Forms. If it's empty, create the form first under Forms > New Form, then reload the lesson's settings.

The form shows but submitting doesn't complete the lesson​

  • The visitor must be logged in and enrolled in the course. Completions aren't recorded for guests.
  • Confirm the form selected in the lesson's settings is the same form displayed by the shortcode. The shortcode always displays the configured form, so remove any other form embeds from the content.

[tt_patch_user_progress] appears as text on the page​

The shortcode renders as raw text when the feature is disabled. Enable Shortcode for patching missing progress in the settings. Also check the spelling: this shortcode uses underscores (tt_patch_user_progress), not hyphens.

The patch shortcode runs but a learner is still stuck​

The patch is deliberately conservative: it fills gaps of up to three consecutive topics and does not patch learners who are trying to jump ahead of their furthest point. For larger repairs, adjust the learner's progress manually from their profile in the WordPress admin.

Group leaders click "Create users" and nothing happens​

Each queued user row must be saved with its Save button first. Create users only submits saved rows. Queue the user, click Save on the row, then Create users.

New group members didn't receive their login email​

The login-details email is sent through WordPress mail, which many hosts deliver unreliably by default. Install an SMTP or transactional-mail plugin, send a test, and re-create the affected user or reset their password to trigger a fresh email.

The certificate image shortcode outputs nothing​

[certificate-image-2] outputs nothing when the certificate has no second image set, or when used outside a certificate without an id parameter. Set Featured Image 2 on the certificate and, outside certificate content, pass id="...".

A course called "All Lessons" appeared​

That course is part of the Independent Lesson Completion feature: a hidden course the plugin maintains so lessons can be accessed independently. It's automatically excluded from your course archive. Leave it in place; it disappears from admin lists only if you disable the feature.