Why Are My WP Mail SMTP Settings Not Saving or Updating?
Content
If you've ever tried to update your WP Mail SMTP configuration only to find that your new settings won't stick, or that old settings mysteriously reappear, you're not alone. This is a common but frustrating issue that can prevent your site from sending emails correctly. Let's break down why this happens and the most effective ways to resolve it.
What Does the 'Settings Not Saving' Problem Look Like?
Users typically experience this issue in a few ways:
- Clicking the 'Save Settings' button does nothing; the page doesn't refresh or confirm the save.
- After saving, the settings revert to their previous values.
- Even after uninstalling and reinstalling the plugin, old configuration data repopulates the settings fields.
- The plugin appears to be using credentials from a different mailer or an old server.
Why Do WP Mail SMTP Settings Fail to Save?
Based on community reports and troubleshooting, the root cause is usually one of the following:
1. Plugin or Theme Conflict
This is the most frequent culprit. Another plugin, often a security or optimization tool, can interfere with the AJAX requests WP Mail SMTP uses to communicate with your database and save settings. A theme's functions can sometimes cause similar conflicts.
2. Database Corruption or Permission Issues
In some cases, the database table where WP Mail SMTP stores its settings (wp_options) can become corrupted. Alternatively, your WordPress site's database user might not have the correct write permissions, preventing it from updating the wp_wpmailsmtp_options record.
3. Configuration Override by Constants
WP Mail SMTP allows settings to be hardcoded and locked using constants in the wp-config.php file. If these are defined, they will always override any settings you try to change in the plugin's admin panel, making it seem like your changes aren't saving.
4. Object Caching
On servers with persistent object caching (e.g., Redis, Memcached), outdated configuration data can be served from the cache instead of the current values from the database.
How to Troubleshoot and Fix the Issue
Follow these steps to identify and resolve the problem.
Step 1: Perform a Conflict Test
The first and most important step is to rule out conflicts with other code on your site.
- Switch to a Default Theme: Temporarily switch your theme to a WordPress default theme like Twenty Twenty-Four.
- Deactivate All Plugins: Deactivate every plugin except WP Mail SMTP.
- Test Saving Settings: Try to change and save a setting in WP Mail SMTP. If it works now, you know a conflict is to blame.
- Find the Culprit: Reactivate your plugins one by one, testing the settings save functionality after each one. When the problem returns, the last plugin you activated is the source of the conflict.
Step 2: Check for Hardcoded Constants
Access your site's files via FTP or your hosting provider's file manager. Open the wp-config.php file in the root directory of your WordPress installation. Look for any lines that start with define( 'WPMS_, such as:
define( 'WPMS_ON', true );
define( 'WPMS_SMTP_HOST', 'old.example.com' );
If these exist, they are overriding your dashboard settings. You must either edit these constants directly in the file or remove them to manage settings from the WordPress admin area.
Step 3: Clear Object Caching
If your site uses an object cache, clear it entirely. The method to do this depends on your caching solution and hosting provider. You may need to use a plugin-specific button or contact your host for assistance.
Step 4: A Clean Reinstall
If the above steps fail, a complete clean reinstall can often wipe out any corrupted data.
- Go to WP Mail SMTP → Settings → Misc.
- Check the box for "Uninstall WP Mail SMTP" to "Remove all plugin data on uninstall."
- Save the settings.
- Deactivate and delete the WP Mail SMTP plugin.
- Reinstall a fresh copy of the plugin from the WordPress plugin repository.
- Reconfigure your mailer settings from scratch.
Step 5: Check Database Permissions (Advanced)
If you are comfortable with phpMyAdmin or command-line database tools, you can verify that your database user has the SELECT, INSERT, UPDATE, and DELETE privileges on your WordPress database. Your hosting provider's support team can also assist with this check.
Summary
The inability to save settings in WP Mail SMTP is almost always solvable. The process typically involves systematically eliminating conflicts, checking for hardcoded overrides, and ensuring your database is functioning correctly. By following the troubleshooting steps above, you should be able to regain control of your email configuration and get your site's notifications sending smoothly again.
Related Support Threads Support
-
Images not working for Mac Mailhttps://wordpress.org/support/topic/images-not-working-for-mac-mail/
-
Emails not sent after migrationhttps://wordpress.org/support/topic/emails-not-sent-after-migration/
-
iOS 15 Mail and macOS Monterey Mail not getting embedded imageshttps://wordpress.org/support/topic/ios-15-mail-and-macos-monterey-mail-not-getting-embedded-images/
-
503 Error in Backend after WP Update to 6.5.5https://wordpress.org/support/topic/503-error-in-backend-after-wp-update-to-6-5-5/
-
weekly wp mail smtp summaryhttps://wordpress.org/support/topic/weekly-wp-mail-smtp-summary/
-
Attachment Content-Type changed to application/octet-stream;https://wordpress.org/support/topic/attachment-content-type-changed-to-application-octet-stream/
-
can’t update wp mail smtp pluginhttps://wordpress.org/support/topic/cant-update-wp-mail-smtp-plugin/
-
There was a problem while retrieving Options for sendgridhttps://wordpress.org/support/topic/there-was-a-problem-while-retrieving-options-for-sendgrid/
-
PROBLEM CHANGE E-MAIL ADMINISTRATIONhttps://wordpress.org/support/topic/problem-change-e-mail-administration/
-
Wp mail smtp not work in mail with title Some plugins were automatically updatedhttps://wordpress.org/support/topic/wp-mail-smtp-not-work-in-mail-some-plugins-were-automatically-updated/
-
emails showing RFC2047 encodinghttps://wordpress.org/support/topic/emails-showing-rfc2047-encoding/
-
wp mail not sending mail after changing php versionhttps://wordpress.org/support/topic/wp-mail-not-sending-mail-after-changing-php-version/
-
Mails are sent by “postmaster@mydomain”https://wordpress.org/support/topic/mails-are-sent-by-postmastermydomain/
-
Error de autorización WP Mail SMTP 403https://wordpress.org/support/topic/error-de-autorizacion-wp-mail-smtp-403/
-
Mailgun failed (Forbidden)https://wordpress.org/support/topic/mailgun-failed-forbidden/
-
Can i find my emails that i didn;t receive because of WP Mail SMTP problem?https://wordpress.org/support/topic/can-i-find-my-emails-that-i-didnt-receive-because-of-wp-mail-smtp-problem/
-
Would moving to a new host effect pluginhttps://wordpress.org/support/topic/will-moving-to-a-new-host-effect-plugin/
-
Installing the WP SMTP plugin on a Multisitehttps://wordpress.org/support/topic/installing-the-wp-smtp-plugin-on-a-multisite-2/
-
API key invalidhttps://wordpress.org/support/topic/api-key-invalid-9/
-
WP STMP keeps trying to change the server it’s logging intohttps://wordpress.org/support/topic/wp-stmp-keeps-trying-to-change-the-server-its-logging-into/
-
conflicting plugins WP HTML Mailhttps://wordpress.org/support/topic/conflicting-plugins-wp-html-mail/
-
WP SMTP Server and Mailhoghttps://wordpress.org/support/topic/wp-smtp-server-and-mailhog/
-
WP Mail SMTP using old settingshttps://wordpress.org/support/topic/wp-mail-smtp-using-old-settings/
-
Possible to export Settings?https://wordpress.org/support/topic/possible-to-export-settings-2/
-
PHP mail() function no longer works following WP Mail SMTP usehttps://wordpress.org/support/topic/php-mail-function-no-longer-works-following-wp-mail-smtp-use/
-
WORDPRESS – WP Mail SMTP (can’t remove PREVIEW DOMAIN in General/Settings)https://wordpress.org/support/topic/wordpress-wp-mail-smtp-cant-remove-preview-domain-in-general-settings/
-
Issue “POST /wp-json/wp-mail-smtp/v1/webhooks/sendinbluehttps://wordpress.org/support/topic/issue-post-wp-json-wp-mail-smtp-v1-webhooks-sendinblue/
-
Return path remained connected with the old domainhttps://wordpress.org/support/topic/return-path-remained-connected-with-the-old-domain/
-
Mailer: Other SMTP SMTP connect() failed. https://github.com/PHPMailer/PHPMailerhttps://wordpress.org/support/topic/mailer-other-smtp-smtp-connect-failed-https-github-com-phpmailer-phpmailer/
-
Wp mail conflict with BackWPup ?https://wordpress.org/support/topic/wp-mail-conflict-with-backwpup/
-
修正方法を知りたいhttps://wordpress.org/support/topic/%e4%bf%ae%e6%ad%a3%e6%96%b9%e6%b3%95%e3%82%92%e7%9f%a5%e3%82%8a%e3%81%9f%e3%81%84/
-
Clicking Settings in WP Mail SMTP goes to WordPress Login Pagehttps://wordpress.org/support/topic/clicking-settings-in-wp-mail-smtp-goes-to-wordpress-login-page/
-
Home page not loading after installing WP mail SMTPhttps://wordpress.org/support/topic/home-page-not-loading-after-installing-wp-mail-smtp/
-
Message after update 3.5.0 versionhttps://wordpress.org/support/topic/message-after-update-3-5-0-version/
-
Error occur when migrating website from one to otherhttps://wordpress.org/support/topic/error-occur-when-migrating-website-from-one-to-other/
-
Disabling WP SMTP Mail in headless batch scripthttps://wordpress.org/support/topic/disabling-wp-smtp-mail-in-headless-batch-script/
-
Misc settings 404https://wordpress.org/support/topic/misc-settings-404/
-
is this code needed anymorehttps://wordpress.org/support/topic/is-this-code-needed-anymore/
-
WP Mail SMTP Pro Killed My Sitehttps://wordpress.org/support/topic/wp-mail-smtp-pro-killed-my-site/
-
WP MAIL SMPT config lost after site restore with All-In-One-WP-Migrationhttps://wordpress.org/support/topic/wp-mail-smpt-configuration-lost-after-site-restoration-with-all-in-one-wp-migrat/
-
wp-mail gives “Could not install the plugin” on seting uphttps://wordpress.org/support/topic/wp-mail-gives-could-not-install-the-plugin-on-seting-up/
-
Settings wont savehttps://wordpress.org/support/topic/settings-wont-save-27/
-
Switching email hostshttps://wordpress.org/support/topic/switching-email-hosts/
-
MailPoet 3 (New)https://wordpress.org/support/topic/mailpoet-3-new/
-
wp mail smtp not sending mail after change server php versionhttps://wordpress.org/support/topic/wp-mail-smtp-not-sending-mail-after-change-server-php-version/
-
[NSFW] send e-mailhttps://wordpress.org/support/topic/send-e-mail/
-
settings page will not updatehttps://wordpress.org/support/topic/settings-page-will-not-update/
-
Missed Emails After SMTP Change – Can Pro Help?https://wordpress.org/support/topic/missed-emails-after-smtp-change-can-pro-help/
-
Configure php settingshttps://wordpress.org/support/topic/configure-php-settings/
-
WP Mail SMTP Mailer sectionhttps://wordpress.org/support/topic/wp-mail-smtp-mailer-section/