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
- Open /admin/settings/mail-server on your site.
Steps
Choose a task
Use Filter logs
- Open /admin/settings/mail-server on your application domain, using the administrator account for this task.
- 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.
- Select Filter logs. Check the current record, recipients, amount or destination before confirming when those values apply.
- 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.
| Field | What to enter or choose |
|---|---|
| Search | Enter 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. |
| Status | Choose Sent, Failed. |
| SMTP server | Enter the smtp server for this task, using the help or example shown by the form. |
| From | Use the date/time picker. Check the date range and the timezone shown by your account or this screen. |
| To | Use the date/time picker. Check the date range and the timezone shown by your account or this screen. |
Use Save SMTP
- Open /admin/settings/mail-server on your application domain, using the administrator account for this task.
- 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.
- Select Save SMTP. Check the current record, recipients, amount or destination before confirming when those values apply.
- 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.
| Field | What to enter or choose |
|---|---|
| Name | Required. Enter the name for this task, using the help or example shown by the form. |
| Host | Required. Enter the host for this task, using the help or example shown by the form. |
| Port | Required. Enter a number in the unit shown by this setting. Check any currency, duration or count label before saving. Minimum 1. Maximum 65535. |
| Encryption | Required. Enter the encryption for this task, using the help or example shown by the form. |
| Username | Enter the username for this task, using the help or example shown by the form. |
| Password | Enter 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 email | Required. Enter the intended email address. Use an inbox you control when practicing. |
| From name | Enter the from name for this task, using the help or example shown by the form. |
| Daily limit | Enter a number in the unit shown by this setting. Check any currency, duration or count label before saving. Minimum 0. |
| Monthly limit | Enter a number in the unit shown by this setting. Check any currency, duration or count label before saving. Minimum 0. |
| Priority | Enter a number in the unit shown by this setting. Check any currency, duration or count label before saving. Minimum 0. |
| Sent today | Enter a number in the unit shown by this setting. Check any currency, duration or count label before saving. Minimum 0. |
| Sent this month | Enter a number in the unit shown by this setting. Check any currency, duration or count label before saving. Minimum 0. |
| Failed until | Use the date/time picker. Check the date range and the timezone shown by your account or this screen. |
| Active | Enable or select this option only when you want the behavior named by the field. |
| Default server | Enable or select this option only when you want the behavior named by the field. |
Use Send test
- Open /admin/settings/mail-server on your application domain, using the administrator account for this task.
- Find the form containing Recipient email. Complete the relevant fields using the table below. Fields can appear or change after you select an option.
- Select Send test. Check the current record, recipients, amount or destination before confirming when those values apply.
- 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.
| Field | What to enter or choose |
|---|---|
| Recipient email | Required. 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
- Stay in the same account/workspace and reopen the intended record or result screen.
- For saved settings, compare the displayed values with the choices you made. For filters and previews, check the current result scope.
- 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
| Problem | What to check |
|---|---|
| The screen or action is missing | Check the correct administrator account, role, enabled app and plan. A hidden action is not fixed by typing an internal endpoint. |
| A field is rejected | Read 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 empty | Check 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 pending | Check 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
| Method | Source-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 key | Handler |
|---|---|
| test_email | modules/AdminMailServer/app/Http/Controllers/AdminMailServerController.php |