{"id":258,"date":"2026-10-17T14:16:41","date_gmt":"2026-10-17T14:16:41","guid":{"rendered":"http:\/\/plugin-docs.com\/?post_type=doc&#038;p=258"},"modified":"2026-10-18T19:57:53","modified_gmt":"2026-10-18T19:57:53","slug":"configure-smtp-delivery","status":"publish","type":"doc","link":"https:\/\/dragwyb.com\/docs\/configure-smtp-delivery\/","title":{"rendered":"Configure SMTP Delivery"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Smart Form Builder includes SMTP settings that let the plugin send its form notification and confirmation emails through a mail provider. Configure the host and authentication details supplied by your email provider, save the settings, and send a test email before relying on notifications from a live form.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Open the SMTP settings<\/h2>\n\n\n<ol class=\"wp-block-list\">\n\n<li>In the WordPress dashboard, open <strong>Smart Forms \u2192 Settings<\/strong>.<\/li>\n\n\n<li>Select the <strong>SMTP<\/strong> tab.<\/li>\n\n\n<li>Turn on <strong>Enable SMTP Delivery<\/strong>. SMTP is disabled by default.<\/li>\n\n\n<li>Configure the fields described below using the settings provided by your email service or hosting provider.<\/li>\n\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Choose a provider preset or enter server details<\/h2>\n\n\n<p class=\"wp-block-paragraph\"><strong>Guided Setup \/ Preset Providers<\/strong> offers presets for Gmail \/ Google Workspace, Microsoft 365 \/ Outlook, Brevo (Sendinblue), SendGrid, Mailgun, Amazon SES, Zoho, cPanel \/ DirectAdmin, and Custom SMTP. For providers with a matching setup guide, choosing a preset fills common connection values and displays provider-specific instructions. Always compare the suggested values with your provider\u2019s current requirements.<\/p>\n\n\n<h3 class=\"wp-block-heading\">Configure the connection<\/h3>\n\n\n<ul class=\"wp-block-list\">\n\n<li><strong>SMTP Host:<\/strong> the outgoing mail server hostname supplied by your provider. The default is blank.<\/li>\n\n\n<li><strong>SMTP Port:<\/strong> the port used by the server. The configured default is <strong>587<\/strong>; common options shown by the plugin are 587 for TLS, 465 for SSL, or 25 for no encryption.<\/li>\n\n\n<li><strong>Encryption:<\/strong> choose <strong>TLS (Port 587)<\/strong>, <strong>SSL (Port 465)<\/strong>, or <strong>None (Port 25)<\/strong>. The configured default is TLS.<\/li>\n\n\n<li><strong>Server Requires Authentication:<\/strong> enable this when the server requires credentials. The configured default is enabled.<\/li>\n\n\n<li><strong>SMTP Username:<\/strong> the username or mailbox address required by your server. This appears when SMTP authentication is enabled.<\/li>\n\n\n<li><strong>SMTP Password:<\/strong> the password, app password, or SMTP credential required by your provider. The field is masked in the settings interface.<\/li>\n\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Set the sender and delivery scope<\/h3>\n\n\n<ul class=\"wp-block-list\">\n\n<li><strong>From Email (Optional):<\/strong> set the sender address if your provider expects a specific verified address. Leave it blank only when the provider and server configuration allow the existing sender to be used.<\/li>\n\n\n<li><strong>From Name (Optional):<\/strong> set the name recipients see as the sender.<\/li>\n\n\n<li><strong>Apply to all site emails:<\/strong> leave this off if you want the SMTP configuration scoped to Smart Form Builder email actions. Turn it on only if you also want the plugin to route other WordPress emails, including WooCommerce and password-reset emails, through this SMTP server. The configured default is off.<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Save settings and send a test email<\/h2>\n\n\n<ol class=\"wp-block-list\">\n\n<li>Select <strong>Save Settings<\/strong> in the settings header and wait for the save confirmation.<\/li>\n\n\n<li>In the SMTP tab\u2019s <strong>Send Test Email<\/strong> area, enter an address you can access.<\/li>\n\n\n<li>Select <strong>Send Test Email<\/strong> and wait for the result.<\/li>\n\n\n<li>If the test succeeds, check the recipient inbox and spam folder. A successful send response does not guarantee inbox placement.<\/li>\n\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Troubleshoot a failed test<\/h2>\n\n\n<ul class=\"wp-block-list\">\n\n<li><strong>SMTP is not configured:<\/strong> confirm <strong>Enable SMTP Delivery<\/strong> is on and <strong>SMTP Host<\/strong> is filled in.<\/li>\n\n\n<li><strong>Authentication failure:<\/strong> verify the username and password expected by the provider. Some providers require an app password or generated SMTP credential rather than the normal account password.<\/li>\n\n\n<li><strong>Microsoft 365:<\/strong> the provider instructions note that SMTP AUTH may need to be enabled by an administrator for the mailbox.<\/li>\n\n\n<li><strong>Connection or encryption error:<\/strong> verify the host, port, and encryption combination against the provider\u2019s current documentation.<\/li>\n\n\n<li><strong>Generic failure in the settings screen:<\/strong> the REST-based settings UI displays a general failure message. More detailed mailer errors are written to the server\u2019s PHP error log by the current implementation; the UI does not show the full SMTP transcript.<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Version 1.3.6 provider-preset limitation<\/h2>\n\n\n<p class=\"wp-block-paragraph\">The SMTP provider list uses the value <strong>amazon_ses<\/strong> for Amazon SES, while the preset setup component looks for the key <strong>ses<\/strong>. As a result, selecting Amazon SES does not match the preset\u2019s key and may not prefill the server details or show its setup instructions. Enter the values supplied by Amazon SES manually until this mismatch is corrected.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">After the test email succeeds, submit a test form with <strong>Send Admin Email<\/strong> or <strong>Send User Email<\/strong> enabled. If the form notification still does not arrive, see <a href=\"https:\/\/dragwyb.com\/docs\/docs\/smart-form-builder\/configure-form-email-notifications\/\"><strong>Configure Form Email Notifications<\/strong><\/a> and <a href=\"https:\/\/dragwyb.com\/docs\/docs\/smart-form-builder\/why-are-form-submissions-not-sending-email\/\"><strong>Why are form submissions not sending email?<\/strong><\/a>.<\/p>\n\n\n\n\n<p class=\"wp-block-paragraph\">Screenshot to add: Smart Forms Settings SMTP tab showing Enable SMTP Delivery, connection settings, and Send Test Email<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Enable Smart Form Builder SMTP delivery, configure the mail server and sender, save settings, and send a test email.<\/p>\n","protected":false},"author":0,"featured_media":0,"parent":253,"menu_order":0,"template":"","class_list":["post-258","doc","type-doc","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/258","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc"}],"about":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/types\/doc"}],"version-history":[{"count":1,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/258\/revisions"}],"predecessor-version":[{"id":1183,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/258\/revisions\/1183"}],"up":[{"embeddable":true,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/253"}],"wp:attachment":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/media?parent=258"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}