Troubleshooting

Most problems come down to SMTP configuration, missing template positions, or data that hasn't been migrated yet.

Emails not being received

  1. Check Email Logs for failed entries — the error column shows the exact reason.
  2. Verify SMTP via WP Mail SMTP → Tools → Email Test.
  3. Make sure From Email exactly matches your SMTP login (the most common cause).
  4. Check spam — usually means missing SPF/DKIM records.
  5. For bulk sends, check whether the queue is paused on a rate limit.

"Successfully queued 0 certificates" or "No certificate records found"

The filter matched recipients but there are no rows in the certificate table yet. Run Certificate Generator → Migration (or import via Bulk Import), then retry.

Certificate PDF not generating

  • Make sure the template has all field positions set — a missing position aborts generation.
  • Confirm the uploads directory is writable.
  • Enable WP_DEBUG_LOG and check wp-content/debug.log.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

ZIP not attaching

ZIPs need PHP's ZipArchive extension and a writable uploads directory. ZIPs over 25 MB are sent as a download link instead of an attachment.