FluxBilling
Communications

Email Logs

Audit outbound email in FluxBilling: status cards, search and filter, a detail view with the rendered body and error, and one-click retry on failed messages.

Updated · 2026-09-03

What Email Logs is for

Email Logs is the outbound mail record for your platform. Every message the system generates — transactional notifications such as invoice paid, order confirmation and password reset, ticket notifications, and campaign messages — is recorded here with its delivery status, recipient and timestamp. When a customer says they never received an email, this is the first place to look: you can see whether the message went out, is still in flight, or failed, and read the exact error your mail provider returned.

Email Logs page showing colored status count cards across the top, a search box and status dropdown, and a table of outbound messages with Status, Recipient, Subject, Event, Date and Actions columns
The Email Logs page: status cards, filters, and the per-message table.

How to open Email Logs

There are two views of the same data:

  • The compact list — go to SettingsEmail and open the Logs tab. It shows the twenty most recent messages in a short scrollable list, each with the recipient's address, the subject and the date, plus a search box and a small status filter (All, Sent, Failed, Pending). Handy for a glance while you are already configuring email, but it offers no detail view and no retry. When there is nothing to show it reads No email logs found.
  • The full Email Logs page — the page documented here. It adds the status count cards, full filtering, pagination, the per-message detail window and one-click retry on failed messages. It is not listed in the sidebar; reach it by adding /emails/logs to your admin panel address, for example https://admin.example.com/emails/logs.

The full page heading reads Email Logs with the subtitle Track all sent and pending emails.

The statuses a message moves through

What each status means on a log entry.
StatusMeaning
sendingThe message has been written to the log and is being handed to your mail provider right now. This is the state every message starts in, and most messages pass through it in under a second.
sentYour provider accepted the message for delivery. The entry also records the time it was sent.
failedThe attempt returned an error, which is stored on the entry. These are the messages you can retry.
pending / queuedWaiting states for messages held before dispatch.
bouncedAvailable as a filter for messages recorded as undeliverable.

Note: A message your provider refuses — a bad address, a blocked domain, an authentication problem — is recorded as failed, with the refusal text in the entry's Error panel. That is the status to watch when you are chasing a delivery complaint.

Note: A message that never reports an outcome — because the platform restarted mid-send, for instance — is moved to failed after about fifteen minutes, with a note explaining that it was recovered from a stuck state. Doing so is what makes it retryable.

Reading the status cards

Across the top of the full page is a row of coloured count cards, one for each status that has had activity in the last 24 hours. A status with no messages in that window gets no card, so the row grows and shrinks with your traffic. Each card shows the status name, the count, and the label Last 24 hours.

The cards are clickable: click one to filter the table below to that status, and the card gains a blue ring. Click it again to clear the filter.

Tip: The cards only count the last 24 hours, so an older message will not be reflected in them even though it is still in the table. Use the search box or the status dropdown to look further back rather than relying on the card counts.

Finding a specific message

Two controls sit above the table:

  1. Search box — placeholder Search by email or subject.... It matches the recipient's address or any part of the subject line.
  2. Status dropdown — choose All Status, Pending, Queued, Sent, Failed or Bounced. This dropdown and the status cards drive the same filter, so changing one updates the other. Leave it on All Status to include messages that are still in the sending state, which the dropdown has no entry of its own for.

When nothing matches, the table shows No logs found. Reopening or navigating back to the page fetches the current list.

The log table

Each row is one outbound message.

Columns in the Email Logs table.
ColumnWhat it shows
StatusA coloured badge with an icon carrying the status name.
RecipientThe recipient's name on the first line and their email address below it. If the message went to one of your clients, the name links straight to that client's record.
SubjectThe rendered subject line, truncated if long.
EventThe event that triggered the send. A dash appears for messages with no associated event, such as campaign messages.
DateWhen the message was created. If it went out, a second line reads Sent: … with the delivery time.
ActionsA View Details (eye) button on every row, plus a Retry button that appears only on failed rows.

The table shows 25 messages per page. When there is more than one page, controls at the bottom show Showing X to Y of Z, a Page X of Y indicator, and previous/next arrows.

Inspecting a single message

Click the View Details (eye) icon on any row to open the Email Details window. It shows:

Status
The current status of this message.
Attempts
How many delivery attempts have been made against the allowance recorded for the message, shown as a pair such as 1 / 3. This tells you at a glance whether a failure is a first try or a repeated one.
Recipient
The address the message was sent to.
Event
The triggering event, or Manual when the message was not tied to an automatic event.
Subject
The full subject line.
Error
Shown only when something went wrong — a red panel containing the exact error text returned during sending.
HTML Content
The rendered message body for that recipient, with the placeholders already filled in.

Close the window with the X in its top-right corner.

Note: The message body is restricted to super administrators. Sent emails can contain live password-reset links and provisioned server credentials, so for anyone else this panel reads Message content is restricted to super admins — sent emails can contain password-reset links and provisioned credentials. Every other field in the window, and the whole table, remain visible to any administrator with settings access.

Note: The stored body is the message as it was rendered, before your company email signature is attached. A missing signature here does not mean it was missing from the delivered email — see Email Signature.

How retries work

Automatic

When a send fails for a reason that looks temporary — your mail provider asking you to slow down, a dropped connection, a timeout — the platform tries again on its own, twice, a couple of seconds and then a few seconds later. A permanent refusal, such as a mailbox that does not exist or content the provider blocks, is not retried automatically, because repeating it only damages your sending reputation.

By hand

  1. Filter to Failed using the status card or the dropdown.
  2. Open View Details and read the Error text to confirm the cause — a bad address, an authentication problem, a provider outage.
  3. Fix the underlying cause first. Retrying without changing anything reproduces the same failure.
  4. Click the Retry (circular-arrow) button on the failed row. The icon spins while the retry is submitted, and the row's status moves on when the attempt completes.

Note: Retry appears only on rows whose status is failed. Sent, bounced, pending and queued rows do not offer it, because they either already succeeded or are still in progress.

Two things will stop a retry, and both report why:

  • The attempt ceiling. A message that has already been attempted five times is not retried again, so a permanently bad address cannot be looped over your mail provider indefinitely. Correct the address on the customer's record and re-trigger the original action instead.
  • Content that is no longer stored. Messages carrying credentials — password resets, email verification, provisioned server passwords — have their bodies cleared once they are old, so there is nothing left to re-send. The refusal says so and tells you to re-trigger the original action, which produces a fresh message with a fresh link.

Common tasks

  • Answer "I never got it". Search the customer's address, look at the newest row's status. sent means your provider took it — point the customer at their spam folder. failed means the error text tells you why.
  • See every email one action produced. Scan the Event column. If a client complains they got several messages at once for a single transaction, the events show exactly which ones fired.
  • Check one customer's mail history. Open the customer's record, which lists the messages sent to them alongside their other activity. See Client Details.
  • Judge overall health. Glance at the failed card. A run of failures usually points at your sending configuration rather than at individual addresses — open a few rows, read the errors, and review the Provider sub-tab covered in Email before retrying in bulk.

Related

Email · Email Templates · Email Signature · Email Broadcast · Client Details