{ "$schema": "https://configops.pyrra.net/atlas/options.schema.json", "verified": true, "canonical": "https://configops.pyrra.net/atlas/options/wp_mail_smtp", "generatedAt": "2026-08-25", "source": { "commit": "e319f502ff677bd76e53b7034650f9ee2afead72", "url": "https://github.com/PyrraNet/ConfigOps/blob/e319f502ff677bd76e53b7034650f9ee2afead72/src/Adapter/WpMailSmtpAdapter.php" }, "option": { "name": "wp_mail_smtp", "slug": "wp_mail_smtp", "path": "/atlas/options/wp_mail_smtp", "label": "Sender email", "seoTitle": "wp_mail_smtp: WP Mail SMTP WordPress Option | ConfigOps", "summary": "wp_mail_smtp is owned by WP Mail SMTP in the tested WP Mail SMTP 4.7–4.9 ConfigOps contract. It is a structured option with 67 exact mapped fields in adapter schema 3.", "description": "wp_mail_smtp: WP Mail SMTP owns this associative array with nested fields with 67 mapped fields. See secrets, WP-CLI reads, ConfigOps Undo limits, and source evidence.", "owner": { "id": "wp-mail-smtp", "name": "WP Mail SMTP", "componentType": "WordPress plugin", "testedVersion": "WP Mail SMTP 4.7–4.9", "testedVersionConstraint": ">=4.7 <5.0", "schemaVersion": 3, "componentFile": "wp-mail-smtp/wp_mail_smtp.php", "sourceFile": "src/Adapter/WpMailSmtpAdapter.php", "sourceUrl": "https://github.com/PyrraNet/ConfigOps/blob/e319f502ff677bd76e53b7034650f9ee2afead72/src/Adapter/WpMailSmtpAdapter.php" }, "status": "configuration", "statusDescription": "Verified configuration option in a pinned ConfigOps adapter contract.", "verification": "Tested ConfigOps adapter assignment", "adminSurface": "WP Mail SMTP → Settings → General, Mailer and Misc settings", "valueShape": "Associative array with nested fields", "valueNotes": [], "fields": [ { "path": "/mail/from_email", "label": "Sender email", "group": "Message identity", "kind": "environment", "explanation": "The address recipients see. It often differs by website or environment.", "referenceType": null }, { "path": "/mail/from_name", "label": "Sender name", "group": "Message identity", "kind": "portable", "explanation": "The name recipients see next to the sender address.", "referenceType": null }, { "path": "/mail/mailer", "label": "Delivery method", "group": "Connection", "kind": "environment", "explanation": "Selects PHP mail, SMTP, or a provider API.", "referenceType": null }, { "path": "/mail/return_path", "label": "Match return path", "group": "Message identity", "kind": "portable", "explanation": "Sends delivery failures back to the sender address.", "referenceType": null }, { "path": "/mail/from_email_force", "label": "Use this sender email everywhere", "group": "Message identity", "kind": "portable", "explanation": "Prevents other plugins from replacing the sender email.", "referenceType": null }, { "path": "/mail/from_name_force", "label": "Use this sender name everywhere", "group": "Message identity", "kind": "portable", "explanation": "Prevents other plugins from replacing the sender name.", "referenceType": null }, { "path": "/smtp/host", "label": "SMTP server", "group": "SMTP connection", "kind": "environment", "explanation": "The mail server hostname for this website.", "referenceType": null }, { "path": "/smtp/port", "label": "SMTP port", "group": "SMTP connection", "kind": "environment", "explanation": "The port used to connect to the mail server.", "referenceType": null }, { "path": "/smtp/encryption", "label": "Connection encryption", "group": "SMTP connection", "kind": "portable", "explanation": "The TLS or SSL mode used by the connection.", "referenceType": null }, { "path": "/smtp/autotls", "label": "Automatic TLS", "group": "SMTP connection", "kind": "portable", "explanation": "Lets the mail library enable TLS when the server supports it.", "referenceType": null }, { "path": "/smtp/auth", "label": "SMTP authentication", "group": "SMTP connection", "kind": "portable", "explanation": "Controls whether the server requires a username and password.", "referenceType": null }, { "path": "/smtp/user", "label": "SMTP username", "group": "SMTP connection", "kind": "environment", "explanation": "The account name used for this website’s mail server.", "referenceType": null }, { "path": "/smtp/pass", "label": "SMTP password", "group": "SMTP connection", "kind": "secret", "explanation": "A credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/general/do_not_send", "label": "Stop all outgoing email", "group": "Delivery policy", "kind": "environment", "explanation": "Blocks email sent through wp_mail() on this website, except WP Mail SMTP test messages.", "referenceType": null }, { "path": "/general/am_notifications_hidden", "label": "Hide plugin announcements", "group": "Admin experience", "kind": "portable", "explanation": "Hides WP Mail SMTP announcements and update details.", "referenceType": null }, { "path": "/general/email_delivery_errors_hidden", "label": "Hide delivery-error warnings", "group": "Admin experience", "kind": "environment", "explanation": "Hides admin warnings when this website cannot deliver email.", "referenceType": null }, { "path": "/general/dashboard_widget_hidden", "label": "Hide dashboard widget", "group": "Admin experience", "kind": "portable", "explanation": "Hides the WP Mail SMTP dashboard widget.", "referenceType": null }, { "path": "/general/usage-tracking-enabled", "label": "Allow usage tracking", "group": "Privacy", "kind": "environment", "explanation": "Controls whether WP Mail SMTP sends usage telemetry from this website.", "referenceType": null }, { "path": "/general/summary_report_email_disabled", "label": "Disable weekly email summaries", "group": "Reports", "kind": "portable", "explanation": "Stops WP Mail SMTP from sending its weekly summary email.", "referenceType": null }, { "path": "/general/optimize_email_sending_enabled", "label": "Optimize email sending", "group": "Delivery policy", "kind": "environment", "explanation": "Queues wp_mail() delivery asynchronously, which can delay messages.", "referenceType": null }, { "path": "/general/uninstall", "label": "Delete WP Mail SMTP data on uninstall", "group": "Data lifecycle", "kind": "environment", "explanation": "Removes the plugin’s settings and data when WP Mail SMTP is deleted.", "referenceType": null }, { "path": "/license/key", "label": "License key", "group": "License", "kind": "secret", "explanation": "A plugin credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/amazonses/client_id", "label": "Access key ID", "group": "Amazon SES connection", "kind": "secret", "explanation": "An Amazon SES credential identifier. ConfigOps removes it together with the secret access key.", "referenceType": null }, { "path": "/amazonses/client_secret", "label": "Secret access key", "group": "Amazon SES connection", "kind": "secret", "explanation": "An Amazon SES credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/amazonses/region", "label": "AWS region", "group": "Amazon SES connection", "kind": "environment", "explanation": "The AWS region that owns this website’s SES account and sending identity.", "referenceType": null }, { "path": "/elasticemail/api_key", "label": "API key", "group": "Elastic Email connection", "kind": "secret", "explanation": "An Elastic Email credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/gmail/one_click_setup_enabled", "label": "One-Click Setup", "group": "Gmail connection", "kind": "environment", "explanation": "Selects the OAuth connection flow used by this website.", "referenceType": null }, { "path": "/gmail/client_id", "label": "Google client ID", "group": "Gmail connection", "kind": "environment", "explanation": "Identifies the Google OAuth application used by this website.", "referenceType": null }, { "path": "/gmail/client_secret", "label": "Google client secret", "group": "Gmail connection", "kind": "secret", "explanation": "A Google OAuth credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/mailersend/api_key", "label": "API token", "group": "MailerSend connection", "kind": "secret", "explanation": "A MailerSend credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/mailersend/has_pro_plan", "label": "Paid MailerSend plan", "group": "MailerSend connection", "kind": "environment", "explanation": "Records which account plan controls this connection’s available sending features.", "referenceType": null }, { "path": "/mailgun/api_key", "label": "Private API key", "group": "Mailgun connection", "kind": "secret", "explanation": "A Mailgun credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/mailgun/domain", "label": "Sending domain", "group": "Mailgun connection", "kind": "environment", "explanation": "The Mailgun domain authorized to send mail for this website.", "referenceType": null }, { "path": "/mailgun/region", "label": "Mailgun region", "group": "Mailgun connection", "kind": "environment", "explanation": "Selects the US or EU Mailgun API endpoint for this account.", "referenceType": null }, { "path": "/mailjet/api_key", "label": "API key", "group": "Mailjet connection", "kind": "secret", "explanation": "A Mailjet credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/mailjet/secret_key", "label": "Secret key", "group": "Mailjet connection", "kind": "secret", "explanation": "A Mailjet credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/mandrill/api_key", "label": "API key", "group": "Mandrill connection", "kind": "secret", "explanation": "A Mandrill credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/outlook/one_click_setup_enabled", "label": "One-Click Setup", "group": "Microsoft 365 / Outlook connection", "kind": "environment", "explanation": "Selects the Microsoft OAuth connection flow used by this website.", "referenceType": null }, { "path": "/outlook/client_id", "label": "Application ID", "group": "Microsoft 365 / Outlook connection", "kind": "environment", "explanation": "Identifies the Microsoft OAuth application used by this website.", "referenceType": null }, { "path": "/outlook/client_secret", "label": "Application password", "group": "Microsoft 365 / Outlook connection", "kind": "secret", "explanation": "A Microsoft OAuth credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/pepipost/host", "label": "SMTP server", "group": "Pepipost SMTP connection", "kind": "environment", "explanation": "The Pepipost SMTP hostname used by this website.", "referenceType": null }, { "path": "/pepipost/port", "label": "SMTP port", "group": "Pepipost SMTP connection", "kind": "environment", "explanation": "The port used for this Pepipost SMTP connection.", "referenceType": null }, { "path": "/pepipost/encryption", "label": "Connection encryption", "group": "Pepipost SMTP connection", "kind": "portable", "explanation": "The TLS or SSL mode used by Pepipost SMTP.", "referenceType": null }, { "path": "/pepipost/auth", "label": "SMTP authentication", "group": "Pepipost SMTP connection", "kind": "portable", "explanation": "Controls whether Pepipost SMTP requires credentials.", "referenceType": null }, { "path": "/pepipost/user", "label": "SMTP username", "group": "Pepipost SMTP connection", "kind": "environment", "explanation": "The account name used by this website’s Pepipost SMTP connection.", "referenceType": null }, { "path": "/pepipost/pass", "label": "SMTP password", "group": "Pepipost SMTP connection", "kind": "secret", "explanation": "A Pepipost credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/pepipostapi/api_key", "label": "API key", "group": "Pepipost API connection", "kind": "secret", "explanation": "A Pepipost credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/postmark/server_api_token", "label": "Server API token", "group": "Postmark connection", "kind": "secret", "explanation": "A Postmark credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/postmark/message_stream", "label": "Message stream", "group": "Postmark connection", "kind": "environment", "explanation": "The Postmark stream that receives mail from this website.", "referenceType": null }, { "path": "/resend/api_key", "label": "API key", "group": "Resend connection", "kind": "secret", "explanation": "A Resend credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/sendgrid/api_key", "label": "API key", "group": "SendGrid connection", "kind": "secret", "explanation": "A SendGrid credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/sendgrid/domain", "label": "Sending domain", "group": "SendGrid connection", "kind": "environment", "explanation": "The SendGrid domain authorized to send mail for this website.", "referenceType": null }, { "path": "/sendinblue/api_key", "label": "API key", "group": "Brevo connection", "kind": "secret", "explanation": "A Brevo credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/sendinblue/domain", "label": "Sending domain", "group": "Brevo connection", "kind": "environment", "explanation": "The Brevo domain authorized to send mail for this website.", "referenceType": null }, { "path": "/sendlayer/api_key", "label": "API key", "group": "SendLayer connection", "kind": "secret", "explanation": "A SendLayer credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/sendlayer/quick_connect", "label": "Quick Connect", "group": "SendLayer connection", "kind": "environment", "explanation": "Records that this website uses SendLayer’s account connection flow.", "referenceType": null }, { "path": "/sendlayer/is_shared_domain", "label": "Shared sending domain", "group": "SendLayer connection", "kind": "environment", "explanation": "Records whether SendLayer assigned this website a shared sending domain.", "referenceType": null }, { "path": "/sendlayer/sender_domain", "label": "Sending domain", "group": "SendLayer connection", "kind": "environment", "explanation": "The SendLayer domain used in this website’s sender address.", "referenceType": null }, { "path": "/sendlayer/free_upgrade_url", "label": "Account upgrade link", "group": "SendLayer connection", "kind": "secret", "explanation": "A signed account-specific URL. ConfigOps removes it before storage.", "referenceType": null }, { "path": "/smtp2go/api_key", "label": "API key", "group": "SMTP2GO connection", "kind": "secret", "explanation": "An SMTP2GO credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/smtpcom/api_key", "label": "API key", "group": "SMTP.com connection", "kind": "secret", "explanation": "An SMTP.com credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/smtpcom/channel", "label": "Sender channel", "group": "SMTP.com connection", "kind": "environment", "explanation": "The SMTP.com channel assigned to mail from this website.", "referenceType": null }, { "path": "/sparkpost/api_key", "label": "API key", "group": "SparkPost connection", "kind": "secret", "explanation": "A SparkPost credential. ConfigOps never stores its clear value.", "referenceType": null }, { "path": "/sparkpost/region", "label": "SparkPost region", "group": "SparkPost connection", "kind": "environment", "explanation": "Selects the US or EU SparkPost API endpoint for this account.", "referenceType": null }, { "path": "/zoho/domain", "label": "Zoho data center", "group": "Zoho Mail connection", "kind": "environment", "explanation": "Selects the Zoho account domain and regional API endpoint.", "referenceType": null }, { "path": "/zoho/client_id", "label": "Zoho client ID", "group": "Zoho Mail connection", "kind": "environment", "explanation": "Identifies the Zoho OAuth application used by this website.", "referenceType": null }, { "path": "/zoho/client_secret", "label": "Zoho client secret", "group": "Zoho Mail connection", "kind": "secret", "explanation": "A Zoho OAuth credential. ConfigOps never stores its clear value.", "referenceType": null } ], "fieldKinds": { "environment": 31, "portable": 12, "secret": 24 }, "fieldCount": 67, "secretFields": [ "/smtp/pass", "/license/key", "/amazonses/client_id", "/amazonses/client_secret", "/elasticemail/api_key", "/gmail/client_secret", "/mailersend/api_key", "/mailgun/api_key", "/mailjet/api_key", "/mailjet/secret_key", "/mandrill/api_key", "/outlook/client_secret", "/pepipost/pass", "/pepipostapi/api_key", "/postmark/server_api_token", "/resend/api_key", "/sendgrid/api_key", "/sendinblue/api_key", "/sendlayer/api_key", "/sendlayer/free_upgrade_url", "/smtp2go/api_key", "/smtpcom/api_key", "/sparkpost/api_key", "/zoho/client_secret" ], "dynamicFieldFamilies": [], "technicalNeighbors": [ { "name": "wp_mail_smtp_activated", "relationship": "Known WP Mail SMTP runtime state in the same adapter contract. It is separated from intended configuration and is not asserted to change on every save." }, { "name": "wp_mail_smtp_activated_time", "relationship": "Known WP Mail SMTP runtime state in the same adapter contract. It is separated from intended configuration and is not asserted to change on every save." }, { "name": "wp_mail_smtp_activation_prevent_redirect", "relationship": "Known WP Mail SMTP runtime state in the same adapter contract. It is separated from intended configuration and is not asserted to change on every save." }, { "name": "wp_mail_smtp_initial_version", "relationship": "Known WP Mail SMTP runtime state in the same adapter contract. It is separated from intended configuration and is not asserted to change on every save." }, { "name": "wp_mail_smtp_source", "relationship": "Known WP Mail SMTP runtime state in the same adapter contract. It is separated from intended configuration and is not asserted to change on every save." }, { "name": "wp_mail_smtp_debug", "relationship": "Known WP Mail SMTP runtime state in the same adapter contract. It is separated from intended configuration and is not asserted to change on every save." }, { "name": "wp_mail_smtp_email_sending_debug", "relationship": "Known WP Mail SMTP runtime state in the same adapter contract. It is separated from intended configuration and is not asserted to change on every save." }, { "name": "wp_mail_smtp_review_notice", "relationship": "Known WP Mail SMTP runtime state in the same adapter contract. It is separated from intended configuration and is not asserted to change on every save." }, { "name": "wp_mail_smtp_sendlayer_quick_connect", "relationship": "Known WP Mail SMTP runtime state in the same adapter contract. It is separated from intended configuration and is not asserted to change on every save." }, { "name": "wp_mail_smtp_summary_report_email_last_sent_week", "relationship": "Known WP Mail SMTP runtime state in the same adapter contract. It is separated from intended configuration and is not asserted to change on every save." }, { "name": "wp_mail_smtp_version", "relationship": "Known WP Mail SMTP runtime state in the same adapter contract. It is separated from intended configuration and is not asserted to change on every save." } ], "technicalBoundary": "Activation, version, debug, migration, counter, notice, scheduler, and provider-usage state is separated from intended mail configuration.", "configOps": { "adapter": true, "adapterId": "wp-mail-smtp", "schemaVersion": 3, "adapterUndo": true, "restoreSummary": "Supported non-secret fields can use adapter-aware, conflict-checked Undo. Redacted secrets are never reconstructed." }, "smartUndo": { "eligible": false, "summary": "No. Smart Undo is only for ordinary associative options that no adapter claims. This option is adapter-owned." }, "cli": [ { "label": "Read the current value", "command": "wp option get wp_mail_smtp --format=json" }, { "label": "Inspect matching storage and autoload metadata", "command": "wp option list --search=wp_mail_smtp --fields=option_name,autoload --format=table" }, { "label": "List top-level keys without changing the value", "command": "wp eval 'print_r( array_keys( (array) get_option( \"wp_mail_smtp\", array() ) ) );'" } ], "autopsies": [ { "title": "Real browser save → review → undo", "status": "browser", "summary": "The exact 4.9.0 browser flow changes sender and SMTP fields, verifies password redaction, reviews seven restorable fields, undoes them, and checks the plugin UI again.", "source": "tests/adapters-user-flow.mjs", "line": 114, "url": "https://github.com/PyrraNet/ConfigOps/blob/e319f502ff677bd76e53b7034650f9ee2afead72/tests/adapters-user-flow.mjs#L114" }, { "title": "Exact-release integration contract", "status": "integration", "summary": "The official plugin settings API is captured with adapter ID, schema version, installed version, classification, and restore eligibility assertions.", "source": "tests/adapters-integration.php", "line": 248, "url": "https://github.com/PyrraNet/ConfigOps/blob/e319f502ff677bd76e53b7034650f9ee2afead72/tests/adapters-integration.php#L248" } ], "aliases": [ "wp mail smtp option name", "where does wp mail smtp store settings", "wp_mail_smtp serialized option", "wp mail smtp password database option", "what plugin writes wp_mail_smtp", "wp_mail_smtp option history", "wp_mail_smtp wordpress option", "track update_option wp_mail_smtp", "what changed wp_mail_smtp", "Sender email", "Message identity", "Sender name", "Message identity", "Delivery method", "Connection", "Match return path", "Message identity", "Use this sender email everywhere", "Message identity", "Use this sender name everywhere", "Message identity", "SMTP server", "SMTP connection", "SMTP port", "SMTP connection", "Connection encryption", "SMTP connection", "Automatic TLS", "SMTP connection", "SMTP authentication", "SMTP connection", "SMTP username", "SMTP connection", "SMTP password", "SMTP connection", "Stop all outgoing email", "Delivery policy", "Hide plugin announcements", "Admin experience", "Hide delivery-error warnings", "Admin experience", "Hide dashboard widget", "Admin experience", "Allow usage tracking", "Privacy", "Disable weekly email summaries", "Reports", "Optimize email sending", "Delivery policy", "Delete WP Mail SMTP data on uninstall", "Data lifecycle", "License key", "License", "Access key ID", "Amazon SES connection", "Secret access key", "Amazon SES connection", "AWS region", "Amazon SES connection", "API key", "Elastic Email connection", "One-Click Setup", "Gmail connection", "Google client ID", "Gmail connection", "Google client secret", "Gmail connection", "API token", "MailerSend connection", "Paid MailerSend plan", "MailerSend connection", "Private API key", "Mailgun connection", "Sending domain", "Mailgun connection", "Mailgun region", "Mailgun connection", "API key", "Mailjet connection", "Secret key", "Mailjet connection", "API key", "Mandrill connection", "One-Click Setup", "Microsoft 365 / Outlook connection", "Application ID", "Microsoft 365 / Outlook connection", "Application password", "Microsoft 365 / Outlook connection", "SMTP server", "Pepipost SMTP connection", "SMTP port", "Pepipost SMTP connection", "Connection encryption", "Pepipost SMTP connection", "SMTP authentication", "Pepipost SMTP connection", "SMTP username", "Pepipost SMTP connection", "SMTP password", "Pepipost SMTP connection", "API key", "Pepipost API connection", "Server API token", "Postmark connection", "Message stream", "Postmark connection", "API key", "Resend connection", "API key", "SendGrid connection", "Sending domain", "SendGrid connection", "API key", "Brevo connection", "Sending domain", "Brevo connection", "API key", "SendLayer connection", "Quick Connect", "SendLayer connection", "Shared sending domain", "SendLayer connection", "Sending domain", "SendLayer connection", "Account upgrade link", "SendLayer connection", "API key", "SMTP2GO connection", "API key", "SMTP.com connection", "Sender channel", "SMTP.com connection", "API key", "SparkPost connection", "SparkPost region", "SparkPost connection", "Zoho data center", "Zoho Mail connection", "Zoho client ID", "Zoho Mail connection", "Zoho client secret", "Zoho Mail connection" ], "sourceReferences": [ { "label": "WP Mail SMTP adapter source", "url": "https://github.com/PyrraNet/ConfigOps/blob/e319f502ff677bd76e53b7034650f9ee2afead72/src/Adapter/WpMailSmtpAdapter.php" }, { "label": "ConfigOps adapter documentation", "url": "https://github.com/PyrraNet/ConfigOps/blob/e319f502ff677bd76e53b7034650f9ee2afead72/docs/adapters.md" } ], "updated": "2026-08-25" } }