Skip to main content

Troubleshooting

Overview​

This troubleshooting guide helps you diagnose and resolve common issues with the Frontend Reset Password plugin. Each issue includes symptoms, causes, and step-by-step solutions.

Common issues​

Email delivery problems​

Password reset emails not being received by users.

Symptoms:

  • Users don't receive reset emails
  • Emails go to spam folder
  • Email delivery is delayed

See: Email not sending guide

Invalid or expired key errors​

Users see error messages when clicking reset links.

Symptoms:

  • "Invalid or expired key" message
  • "Key is no longer valid" error
  • Reset link doesn't work

See: Invalid or expired key guide

Form display issues​

Password reset forms don't appear on the page.

Symptoms:

  • Blank page where form should be
  • Shortcode displays as text
  • Form appears but doesn't function

See: Form not displaying guide

Password validation problems​

Password requirements not working correctly.

Symptoms:

  • Validation messages don't appear
  • Requirements not enforced
  • JavaScript errors in console

See: Password validation issues guide

Quick diagnostic steps​

Step 1: Check plugin activation​

Verify the plugin is active:

  1. Go to Plugins > Installed Plugins
  2. Find "Frontend Reset Password"
  3. Ensure status shows "Active"

Step 2: Verify shortcode placement​

Check the shortcode is on the correct page:

  1. Go to Pages > All Pages
  2. Find your reset password page
  3. Edit the page
  4. Verify [reset_password] shortcode is present

Step 3: Check plugin settings​

Verify settings are configured:

  1. Go to Settings > Frontend Reset Password
  2. Check "Reset Password Page" is selected
  3. Verify email settings are complete
  4. Save changes if modified

Step 4: Test with default theme​

Switch to a default WordPress theme temporarily:

  1. Go to Appearance > Themes
  2. Activate Twenty Twenty-Four (or another default theme)
  3. Test password reset flow
  4. If it works, the issue is theme-related

Step 5: Check for plugin conflicts​

Disable other plugins temporarily:

  1. Go to Plugins > Installed Plugins
  2. Deactivate all plugins except Frontend Reset Password
  3. Test password reset flow
  4. Reactivate plugins one by one to identify conflicts

Debug mode​

Enable WordPress debug mode to see detailed error messages:

wp-config.php
// Add to wp-config.php
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Check debug log at: wp-content/debug.log

Getting help​

If you can't resolve the issue:

  1. Check the FAQ for common questions
  2. Review Resources and support for help channels
  3. Gather diagnostic information:
    • WordPress version
    • PHP version
    • Active theme
    • Active plugins
    • Error messages from debug log

What's next​