All guides
Admin

Mail Server

Screen guide

Before you start

Use an administrator account with permission to manage this feature. The feature also needs to be enabled for this installation and plan.

Open this feature
  1. Open /admin/settings/mail-server on your site.

Steps

Use Filter logs

  1. Open /admin/settings/mail-server on your application domain, using the administrator account for this task.
  2. Find the form containing Search, Status, SMTP server. Complete the relevant fields using the table below. Fields can appear or change after you select an option.
  3. Select Filter logs. Check the current record, recipients, amount or destination before confirming when those values apply.
  4. If the application identifies a missing or invalid field, correct that field and submit again. If an external request or payment has an uncertain outcome, check its history before repeating it.
FieldWhat to enter or choose
SearchEnter the search for this task, using the help or example shown by the form. The form’s example is Recipient or subject. Replace it with your own value.
StatusChoose Sent, Failed.
SMTP serverEnter the smtp server for this task, using the help or example shown by the form.
FromUse the date/time picker. Check the date range and the timezone shown by your account or this screen.
ToUse the date/time picker. Check the date range and the timezone shown by your account or this screen.

Use Save SMTP

  1. Open /admin/settings/mail-server on your application domain, using the administrator account for this task.
  2. Find the form containing Name, Host, Port. Complete the relevant fields using the table below. Fields can appear or change after you select an option.
  3. Select Save SMTP. Check the current record, recipients, amount or destination before confirming when those values apply.
  4. If the application identifies a missing or invalid field, correct that field and submit again. If an external request or payment has an uncertain outcome, check its history before repeating it.
FieldWhat to enter or choose
NameRequired. Enter the name for this task, using the help or example shown by the form.
HostRequired. Enter the host for this task, using the help or example shown by the form.
PortRequired. Enter a number in the unit shown by this setting. Check any currency, duration or count label before saving. Minimum 1. Maximum 65535.
EncryptionRequired. Enter the encryption for this task, using the help or example shown by the form.
UsernameEnter the username for this task, using the help or example shown by the form.
PasswordEnter the value privately from your account or the service configuration. Do not use sample credentials from a guide. The form’s example is SMTP password. Replace it with your own value.
From emailRequired. Enter the intended email address. Use an inbox you control when practicing.
From nameEnter the from name for this task, using the help or example shown by the form.
Daily limitEnter a number in the unit shown by this setting. Check any currency, duration or count label before saving. Minimum 0.
Monthly limitEnter a number in the unit shown by this setting. Check any currency, duration or count label before saving. Minimum 0.
PriorityEnter a number in the unit shown by this setting. Check any currency, duration or count label before saving. Minimum 0.
Sent todayEnter a number in the unit shown by this setting. Check any currency, duration or count label before saving. Minimum 0.
Sent this monthEnter a number in the unit shown by this setting. Check any currency, duration or count label before saving. Minimum 0.
Failed untilUse the date/time picker. Check the date range and the timezone shown by your account or this screen.
ActiveEnable or select this option only when you want the behavior named by the field.
Default serverEnable or select this option only when you want the behavior named by the field.

Use Send test

  1. Open /admin/settings/mail-server on your application domain, using the administrator account for this task.
  2. Find the form containing Recipient email. Complete the relevant fields using the table below. Fields can appear or change after you select an option.
  3. Select Send test. Check the current record, recipients, amount or destination before confirming when those values apply.
  4. If the application identifies a missing or invalid field, correct that field and submit again. If an external request or payment has an uncertain outcome, check its history before repeating it.
FieldWhat to enter or choose
Recipient emailRequired. Enter the intended email address. Use an inbox you control when practicing. The form’s example is you. Replace it with your own value.

Fields and choices

Field descriptions appear beside each task above so that separate forms are not mixed together.

Check the result

  1. Stay in the same account/workspace and reopen the intended record or result screen.
  2. For saved settings, compare the displayed values with the choices you made. For filters and previews, check the current result scope.
  3. For queued or external work, inspect its status/history and provider result where applicable. A successful save does not by itself prove message delivery, publication, payment completion or provider approval.

Common problems

ProblemWhat to check
The screen or action is missingCheck the correct administrator account, role, enabled app and plan. A hidden action is not fixed by typing an internal endpoint.
A field is rejectedRead its validation message, choose from the offered options and check the relevant format or limit. Do not substitute a database ID for a displayed choice.
A list is emptyCheck the selected workspace, search text, date range and status filters. Clear one filter at a time before concluding that records are missing.
A request is still pendingCheck its status/history before repeating it. For messages, publishing, imports and payments, a submitted request can finish later or fail separately.

Technical reference

Role-scoped source references

Pinned commit: 275481cdd3c8519a24c5ecf5cac3e11ceb1708d8

Source-only route information
MethodSource-default route
GET/admin/settings/mail-server
POST/admin/settings/mail-server/rotation
POST/admin/settings/mail-server/servers
PUT/admin/settings/mail-server/servers/{server}
DELETE/admin/settings/mail-server/servers/{server}
POST/admin/settings/mail-server/servers/{server}/toggle
POST/admin/settings/mail-server/servers/{server}/default
POST/admin/settings/mail-server/servers/{server}/exhausted
POST/admin/settings/mail-server/servers/{server}/test
POST/admin/mail-server/test
Unmapped fields — not user instructions

These fields belong to this role’s source handler, but their screen labels were not confirmed.

Source keyHandler
test_emailmodules/AdminMailServer/app/Http/Controllers/AdminMailServerController.php