“Subscriber not found error” when adding contacts to a list via button click

[User]

Hi there,

I am having a widespread issue with the buttons in my newsletters: when I configure a button with a standard link it works perfectly, but the moment I enable the option to “add contact to a list” upon clicking, the button completely breaks and throws the error Subscriber not found or not confirmed.

This error happens both in edit mode while designing the campaign and to real users when they receive the email, and it occurs regardless of the language or list selected (even if the lists are public).

I need to know how to fix this so the button can successfully add people to the list and redirect to the website at the same time without throwing this subscriber error.

Thank you!

[Michael]

Hello,

I’m not experiencing this issue on our test environments. Could you please send me a test newsletter with the faulty buttons to michael at thenewsletterplugin.com ? Please add my email as confirmed before doing that.

Michael

[User]

Sent.

[User]

This error in The Newsletter Plugin (WordPress) usually appears when the system tries to add or update a contact in a list, but cannot properly identify the subscriber record. It’s typically caused by a mismatch between the button action, subscriber data, or database entry.

Common causes
1. Subscriber does not exist in the database
The email/contact has not been created yet
The system tries to “update” instead of “create”
2. Incorrect subscriber ID or missing reference
The button click action may be pointing to a non-existent subscriber ID
Custom code or automation may be passing an empty value
3. AJAX or JavaScript conflict
Theme or plugin conflicts can break the button request
AJAX call fails, so subscriber lookup fails
4. Cache or session issues
Cached old subscriber data may be used
Session mismatch between frontend and backend
5. Plugin version bug or outdated plugin
Older versions of The Newsletter Plugin may have syncing issues
Database structure mismatch after updates
How to fix it
✔ 1. Verify subscriber exists
Go to Newsletter → Subscribers
Check if the email is already listed
If not, ensure the form is set to “create new subscriber”
✔ 2. Check button/action configuration
Ensure the button is linked to a valid newsletter action
Avoid passing empty or incorrect subscriber IDs
✔ 3. Disable plugin/theme conflicts
Temporarily disable other plugins
Switch to a default theme (like Twenty Twenty-Four)
Test again
✔ 4. Clear cache
Clear WordPress cache plugin
Clear browser cache
Retest the subscription action
✔ 5. Update plugin and WordPress
Update The Newsletter Plugin to the latest version
Ensure WordPress core is up to date
✔ 6. Check browser console (advanced)
Open Developer Tools (F12)
Look for AJAX or JavaScript errors when clicking the button

[Michael]

Hello,

I got your email, and when I clicked on test button it redirected me to homepage. It seems something is off with link generation. Please try this:

1. be sure to create a test list, make it public.
2. add michael@thenewsletterplugin.com as a confirmed test subscriber (check the “test subscriber” checkbox)
3. Create a new newsletter, use blank template
4. Add the buttons block, on button no.1 select “test list” from “On click add to..”
5. Save
6. Send a test
7. Reply here when done.

Thanks,
Michael

[Author]

Posts