# Email Logs

https://docs.wisecp.com/es/email-logs

Check every e-mail the system handed to the mail module, and read the exact message a client received without asking them to forward it.

## Opening the Screen

Open `{admin}/tools/mail-logs` from the Tools menu.

## What Is on the Screen

One table, newest record first, with a search box above it. The search covers the subject line and the recipient addresses. The download button beside the search box exports the filtered list as CSV, JSON or XML.

- **Subject**: The subject line as it was sent. Long subjects are shortened, and the whole of it appears on hover.
- **Addresses**: Who received it. With more than one recipient the first address appears followed by a counter for the rest.
- **Date**: When the message left the system.
- **IP Address**: The address the request came from. The lookup button beside it finds the other records from the same address.
- **Preview**: The eye button at the end of a row opens the message.

### Preview window

The **Email Preview** window shows the subject, the recipients and the send time at the top. Under **Message Content** the message appears exactly as it was sent, with its own layout and images.

A service activation message carries the client's service password. Its body opens only for staff who also hold **View Services**; anyone else sees a short notice instead. The client can still read the message in their own panel.

## Fields

These two belong to the **Clear Logs** dialog, opened by the red button next to the page title. Both are required.

- **Select Date**: The cut-off. Every e-mail record from before this date goes, while that day's own records stay. No default: pick a date each time.
- **Enter your account password for security verification.**: Your own panel password, confirming the deletion came from you.

## Tasks

### Read a message a client received

1. Type the client's e-mail address in the search box.
2. Find the row by its subject and date.
3. Click the eye button. The message opens in the preview window with its recipients and time.

### Check whether a message went out

1. Search for the address, then compare the Date column with the moment the client expected the e-mail.
2. A row means the message was handed over for sending. No row means it never got that far, so check the notification template and the mail module settings.

### Clear old records

1. Click the **Clear Logs** button.
2. Pick a cut-off date and type your account password.
3. Click **Confirm**. The matching records go and the page reloads with the shorter list.

## Things to Watch

> **Nothing removes these records but you**
> 
> E-mail records have no retention period and stay until you clear them or delete the client they belong to. On a busy installation the table grows without limit, so clear it on a routine you choose. Deletion cannot be undone, and the same records fill the Messages list in the client's own panel: what you clear here disappears from there as well.

> **Verification messages have no body**
> 
> Activation codes, password-reset links, sub-user invitations and domain transfer codes record the send event, the subject and the recipient, but their body is replaced by a short notice. Anyone reading the log must not be able to reuse a code that was meant for one inbox.

> **A row is a hand-off, not a delivery receipt**
> 
> The record is written once the mail module accepts the message. What happens afterwards, greylisting, a spam folder or a bouncing mailbox, does not appear here. For that, check the mail provider's own reports.

## Required Privileges

The preview and the **Clear Logs** dialog both need `TOOLS_ACTIONS`. Opening a service activation message also needs `SERVICES_LOOK`; without it the preview shows a notice instead of the body. The download button beside the search box follows the panel-wide `TABLE_EXPORT`; an account without that privilege never sees the button.

## Related Articles

- [SMS Logs](https://docs.wisecp.com/en/sms-logs)
- [Notification Queue](https://docs.wisecp.com/en/notification-delivery-queue)
- [Notification Templates](https://docs.wisecp.com/en/notification-templates)
- [Mail Modules](https://docs.wisecp.com/en/mail-modules)