---
title: "Update SMTP Settings Ability: Configure Email Delivery in WordPress"
url: https://nexterwp.com/docs/nexter-update-smtp-settings/
date: 2026-05-29
modified: 2026-05-29
author: "sandip patel"
description: "The nexter/update-smtp-settings ability updates the SMTP email configuration in Nexter Extension, including connection type, server details, authentication, and sender information."
word_count: 285
---

# Update SMTP Settings Ability: Configure Email Delivery in WordPress

## Key Takeaways

- nexter/update-smtp-settings ability updates SMTP email configuration in Nexter Extension.
- Parameters such as enabled, type, from_name, and host are optional and only the fields passed are saved.
- nexter/get-smtp-settings retrieves current SMTP values before making updates, ensuring secure password storage.

The **nexter/update-smtp-settings** ability updates the SMTP email configuration in Nexter Extension. You can enable or disable SMTP, switch between Gmail and custom SMTP, and configure the server host, port, encryption, and sender details. Only the fields you pass are updated.

## Key Takeaways

All parameters are optional. Only the fields you pass are saved.

Passwords are stored securely and will be masked when read back via nexter/get-smtp-settings.

Use nexter/get-smtp-settings to read current values before making partial updates.

## Required Setup

This ability ships with Nexter Extension (Free). If you do not have it installed, follow the guide on how to install and activate Nexter Extension first.

## Parameters

**enabled** (boolean, optional) turns SMTP delivery on or off.

**type** (string, optional) sets the SMTP connection type. Options: gmail, custom.

**from_name** (string, optional) sets the sender display name used in outgoing emails.

**from_email** (string, optional) sets the sender email address.

**host** (string, optional) is the SMTP server hostname.

**port** (integer, optional) is the SMTP port number. Options: 25, 465, 587.

**encryption** (string, optional) sets the security protocol. Options: tls, ssl, none.

**auto_tls** (boolean, optional) enables automatic TLS upgrade when supported by the server.

**auth** (boolean, optional) enables SMTP authentication.

**username** (string, optional) is the SMTP authentication username.

**password** (string, optional) is the SMTP authentication password. Stored securely and masked when read back.

## What It Returns

The ability returns **success** (boolean) and the updated **settings** object reflecting the new SMTP configuration, with the password field masked.

## When to Use This Ability

Configure SMTP on a newly provisioned site as part of an automated setup workflow.

Update the from_name or from_email without changing server credentials.

Switch from custom SMTP to Gmail OAuth after migrating a site to a new email provider.

## Related Documentation

Get SMTP Settings Ability: nexter/get-smtp-settings

Update Security Settings Ability: nexter/update-security-settings

Update Performance Settings Ability: nexter/update-performance-settings