MailPoet Logs (View, Download and Delete)

MailPoet logs record what the plugin does and the errors it runs into, and you can view them in MailPoet → Help → Logs. This guide shows you how to filter the logs to a problem, download them for MailPoet support, and delete the ones you no longer need.

About MailPoet logs

MailPoet logs are short entries that MailPoet writes while it sends emails, runs background tasks, connects to the MailPoet Sending Service, and checks CAPTCHA, among other jobs. Each entry has a topic, a severity, a message, and the date it was created. When something isn’t working, the error log is often the fastest way to see what went wrong, and MailPoet support may ask you for it.

The Logging setting in MailPoet → Settings → Advanced controls what MailPoet records:

  • Errors only records problems. This is the default.
  • Everything also records routine activity, which helps when you troubleshoot. The log grows fast with this option, so switch back to Errors only when you’re done.
  • Nothing records only emergencies.
The Logging setting in MailPoet Advanced settings, set to Errors only, with a See logs link in its description

MailPoet deletes logs automatically after 30 days.

View MailPoet logs

You view MailPoet logs on the Logs tab of the MailPoet Help page. To open it, follow these steps:

  1. In WP Admin, go to MailPoet → Help.
  2. Click the Logs tab.
The Logs tab on the MailPoet Help page, listing log entries with Name, Severity, Message, and Created On columns

You can also click the link in the Logging setting description in MailPoet → Settings → Advanced.

The list shows the last seven days of logs, newest first. Each row shows these columns:

  • Name: the topic the entry belongs to, such as Sending, Background tasks, or MailPoet Sending Service.
  • Severity: how serious the entry is, from Debug and Info for routine details up to Error and Critical for failures.
  • Message: what happened, in plain language.
  • Created On: the date and time MailPoet wrote the entry.

To see the details of an entry, click “Show more” on its row.

A log entry on the MailPoet Logs tab, with an arrow pointing to the Show more link in the Actions column

The row expands to show the severity, the topic’s technical name, any extra details MailPoet saved, and the full log line. To show the full log line as a column for every row, click the View options button and turn on Full log line.

An expanded MailPoet log entry showing its severity, topic, and full log line, with a Show less button

Filter and search MailPoet logs

Filtering MailPoet logs by date, topic, or severity narrows the list to the problem you’re looking into. To filter the logs, follow these steps:

  1. On the Logs tab, click the filter icon next to the search field, then click “Add filter“.
  2. Choose a filter:
    • Created On: show entries on a date, before or after a date, or between two dates. Use this filter to see logs older than seven days.
    • Name: show entries for one or more topics.
    • Severity: show entries at one or more levels. For example, choose Error and Critical to see only failures.
  3. To find a specific message, type a word or phrase in the “Search logs” field.

The list updates as soon as you change a filter. Search matches the message and the topic’s technical name, such as mss for the MailPoet Sending Service, but not the readable topic name. To sort the list, click the Name or Created On column heading.

If the list says “No logs found for this period,” try a wider date range or clear the filters. If Logging is set to Errors only or Nothing, MailPoet doesn’t record routine activity.

Download MailPoet logs for support

You can download the MailPoet logs that match your current filters and search as a .txt file to attach to a support request. To download the logs, follow these steps:

  1. Filter or search the logs to the entries you want to share.
  2. Click the Download… button.
  3. Check the number of logs in the window, then click the “Download [number] logs” button.

Your browser saves the .txt file. A download includes up to 50,000 logs. If more logs match, MailPoet downloads the 50,000 most recent ones. With no filters or search, the download includes every log MailPoet has kept.

When you contact MailPoet support, attach the log file along with your system status report. To get the report, see Understanding the MailPoet System Status Page.

Delete MailPoet logs

Deleting MailPoet logs permanently removes the entries that match your current filters and search, and you can’t undo it. To clear the logs, follow these steps:

  1. Filter or search the logs to the entries you want to remove. With no filters or search, MailPoet deletes all logs.
  2. Click the “Delete logs…” button.
  3. Check the number of logs in the window, then click the “Delete [number] logs” button.

A message confirms how many logs MailPoet deleted. If you need the logs for support, download them before you delete them.

Related Articles