Plugin how-tos · Guide
How to Uninstall WP Mail SMTP (Step by Step)

Short answer
Go to WP Mail SMTP, Settings, Misc and turn on the option to remove all plugin data on deletion, then save. Next, open Plugins, deactivate WP Mail SMTP and click Delete. Set up another email method first, because WordPress falls back to PHP mail afterwards.
Key takeaways
- Enable the uninstall option in the Misc tab for a clean removal.
- Deactivate, then delete the plugin from the Plugins screen.
- Remove any WPMS_ constants from wp-config.php.
- Use FTP or WP-CLI if you cannot reach the dashboard.
- Set up and test a replacement email method first.
How do you uninstall WP Mail SMTP?
Turn on the plugin's option to remove all data on deletion, then deactivate and delete WP Mail SMTP from the Plugins screen.
If you skip the data option, WordPress still removes the plugin files, but settings and some database tables can stay behind.
Before you remove it, plan what will send your site's emails afterwards. Without an SMTP plugin, WordPress falls back to the server's PHP mail function, and many sites see emails stop arriving.
This guide covers a clean uninstall, what changes after removal, and how to remove the plugin when you cannot reach the dashboard.
If you are unsure what the plugin does, read what WP Mail SMTP is first.
What happens to your emails after you remove it?
WordPress goes back to sending through PHP mail on your server, which many hosts limit or block, so contact forms, password resets and order emails may fail or land in spam.
WP Mail SMTP replaces the default delivery path used by wp_mail(). Once it is gone, that function uses PHP's mail function again.
That may be fine if your host handles mail well. Often it is not.
You can check quickly. After removal, send a password reset to your own account and see whether it arrives, how long it takes, and whether it lands in spam. If it fails, put an SMTP method back in place right away.
Common reasons people uninstall are switching to another SMTP plugin, moving to a host with its own mail service, or cleaning up after a site redesign. In each case, set up the replacement before you delete WP Mail SMTP.
Our guide on how to set up SMTP in WordPress covers the alternatives.
What should you do before uninstalling?
Back up the site, note your mailer settings in case you need them again, and confirm a replacement email method is ready to take over.
Use this checklist:
- Take a backup of the database. See how to back up a WordPress database.
- Write down your mailer, From email, From name and any API or SMTP details you may reuse.
- Export email logs if you use Pro and need records for support or compliance.
- Install the replacement plugin or host mail service, but keep it inactive until WP Mail SMTP is removed, to avoid two plugins competing.
If you use the Pro version, also check your account on the WP Mail SMTP site if you want to free the licence for another site.
How do you make WP Mail SMTP delete all its data?
Go to WP Mail SMTP, Settings, open the Misc tab, enable the uninstall option to remove all plugin data when the plugin is deleted, and save.
- In wp-admin, open WP Mail SMTP > Settings.
- Click the Misc tab.
- Find the Uninstall WP Mail SMTP setting and turn it on.
- Click Save Settings.
The vendor describes this option in its guide to miscellaneous settings.
Without this setting, the plugin keeps its options and tables so you can reinstall later without losing configuration. That is helpful for testing, but not for a clean removal.
If you are only troubleshooting, leave this option off. A quick deactivation is enough to see whether WP Mail SMTP is behind a problem, and reactivating restores everything as it was.
How do you deactivate and delete the plugin?
Go to Plugins, Installed Plugins, click Deactivate under WP Mail SMTP, then click Delete and confirm.
- Open Plugins > Installed Plugins.
- Find WP Mail SMTP or WP Mail SMTP Pro.
- Click Deactivate.
- Click Delete and confirm the prompt.
With the uninstall option on, deleting runs the plugin's cleanup routine and removes its settings and tables.
The WordPress.org page on managing plugins shows these screens if you need a reference.
Do you need to remove anything from wp-config.php?
Yes, if you or a developer defined WP Mail SMTP constants in wp-config.php, remove those lines, since they can hold passwords and are no longer used.
WP Mail SMTP lets you store settings as constants, which keeps secrets out of the database. They usually start with WPMS_, such as WPMS_ON or WPMS_SMTP_PASS.
Open wp-config.php and delete any lines like these:
define( 'WPMS_ON', true );
define( 'WPMS_SMTP_PASS', 'your-password' );
If you do not know where the file is, see where to find wp-config.php in WordPress.
Then change that SMTP password or API key at your email provider if it is no longer needed. Old credentials left lying around are a risk.
How do you uninstall WP Mail SMTP without dashboard access?
Rename or delete the plugin folder in wp-content/plugins using FTP or your host's File Manager, which deactivates it immediately.
- Connect with FTP or open File Manager in your hosting panel.
- Go to wp-content/plugins/.
- Find the wp-mail-smtp folder, or wp-mail-smtp-pro for Pro.
- Rename it to something like wp-mail-smtp-off to deactivate it, or delete it to remove the files.
This removes the code but not the database data, because the cleanup routine never runs.
If you later regain dashboard access, you can reinstall the plugin, enable the uninstall option, and delete it again from the Plugins screen. That runs the proper cleanup without touching the database by hand.
Our guide on uninstalling broken plugins in WordPress covers this method in more detail.
You can also use WP-CLI over SSH. The wp plugin delete command removes the plugin in one line:
wp plugin deactivate wp-mail-smtp
wp plugin delete wp-mail-smtp
How do you remove leftover data manually?
Back up the database, then delete options whose names start with wp_mail_smtp and any tables whose names include wpmailsmtp, using phpMyAdmin.
Leftovers are harmless in small amounts, but you may want a fully clean database.
In phpMyAdmin, search the options table:
SELECT option_name FROM wp_options WHERE option_name LIKE 'wp_mail_smtp%';
Review the results, then delete them. Also look for tables with wpmailsmtp in the name, such as debug event or email log tables, and drop them only if you are sure they belong to this plugin.
Deleting rows in phpMyAdmin cannot be undone without a backup, so export the options table before you start. Work slowly and check each name against the plugin, because other email plugins use similar prefixes.
Replace wp_ with your own table prefix if it differs.
Which removal method should you choose?
Use the dashboard method with the uninstall option for a clean removal; use FTP or WP-CLI only when the dashboard is unavailable or you manage many sites.
| Method | Removes files | Removes settings and tables | When to use |
|---|---|---|---|
| Dashboard with uninstall option on | Yes | Yes | Normal clean removal |
| Dashboard with option off | Yes | No | You may reinstall later |
| FTP or File Manager | Yes | No | Locked out of wp-admin |
| WP-CLI | Yes | Depends on the uninstall option | Developers and many sites |
| Manual database cleanup | No | Yes | After an FTP removal |
How do you check that emails still work afterwards?
Send a test email through your new setup, submit a contact form, and trigger a password reset to confirm messages arrive in the inbox, not spam.
Most SMTP plugins include a test email tool. Use it first.
Then test real site emails. If forms stop sending, see how to fix a contact form not sending email.
For stores, place a test order and check that both the customer and admin emails arrive.
WooCommerce emails have their own settings and templates. If they stop after the switch, read how to fix WooCommerce emails not sending.
Also review your domain's SPF and DKIM records if you changed email providers. Records that still point to the old service can hurt delivery for the new one.
Should you reinstall WP Mail SMTP later?
You can reinstall it from the plugin directory at any time, but if you removed all data you will need to enter your mailer settings again.
The free plugin is on the WP Mail SMTP plugin page. Install it, run the setup wizard, and send a test email.
Keep only one SMTP plugin active at a time. Two plugins fighting over wp_mail can cause unpredictable delivery.
Frequently asked questions
Does deleting WP Mail SMTP remove its settings?
Only if you enable the uninstall option in the Misc tab before deleting. Otherwise, WordPress removes the plugin files but the settings and some database tables stay so you can reinstall without reconfiguring.
Will my site stop sending emails after removing WP Mail SMTP?
It may. WordPress falls back to PHP mail, which many hosts restrict, so emails can fail or go to spam. Set up another SMTP plugin or your host's mail service before removing it.
How do I remove WP Mail SMTP Pro?
Follow the same steps: enable the uninstall option, then deactivate and delete the plugin. If you want to use the licence elsewhere, manage the site activation in your account on the vendor's website.
Can I delete WP Mail SMTP with FTP?
Yes. Delete or rename the plugin folder in wp-content/plugins. This removes the code but leaves database settings, which you can clean up later in phpMyAdmin after taking a backup.
Is it safe to leave WP Mail SMTP data in the database?
Small leftover settings are generally harmless, but they may include mailer details. If you stored passwords there, rotate them at your email provider and remove the leftover options.
Sources
- A Complete Guide to Miscellaneous Settings WP Mail SMTP
- WP Mail SMTP WordPress.org Plugins
- wp_mail() WordPress Developer Resources
- wp plugin delete WordPress Developer Resources
- mail PHP Manual
- Manage Plugins WordPress.org Documentation
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


