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.
What Email Logs is for
Email Logs is the outbound mail audit for your platform. Every message the system generates — transactional notifications (invoice paid, order confirmation, password reset), ticket replies, broadcasts and newsletters — 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 was sent, is still waiting, or failed, and read the exact error without leaving the admin panel.
How to open Email Logs
There are two views of the same email log data:
- The compact list — go to Settings → Email and open the Logs tab. This shows a short, scrollable recent list with each message's recipient, subject and date, plus a search box and a small status filter (All, Sent, Failed, Pending). It is handy for a quick glance while you are already configuring email.
- The full Email Logs page — the page documented here. It adds the status count cards, full search and status filtering, pagination, the per-message detail window, and one-click retry on failed messages.
The full page heading reads Email Logs with the subtitle Track all sent and pending emails.
Reading the status cards
Across the top of the full page is a row of colored count cards — one card for each status that has had activity in the last 24 hours. If no messages reached a given status in that window, that card simply does not appear, so you may see anywhere from one to five cards depending on recent traffic. The possible statuses are:
- Pending — recorded and waiting to be picked up for sending.
- Queued — lined up and waiting its turn to go out.
- Sent — handed off to your email provider for delivery.
- Failed — a delivery attempt returned an error. These can be retried.
- Bounced — the provider reported the address as undeliverable.
Each card shows the count for that status over the last 24 hours, with the label Last 24 hours beneath the number.
The cards are clickable. Click any card to filter the table below to just that status; the active card is highlighted with a ring. Click it again to clear the filter and return to showing all statuses.
Finding a specific message
Two controls sit above the table:
- Search box — type a recipient email address or part of a subject line. The placeholder reads Search by email or subject.... Results filter as you type.
- Status dropdown — choose All Status, Pending, Queued, Sent, Failed or Bounced to limit the table to one status. This dropdown and the status cards control the same filter, so selecting one updates the other.
A Refresh button sits at the top right of the page. When nothing matches your filters, the table shows No logs found.
The log table
Each row is one outbound message. The columns are:
| Column | What it shows |
|---|---|
| Status | A colored badge with an icon: Pending, Queued, Sent, Failed or Bounced. |
| Recipient | The recipient's name on the first line and their email address below it. If the message went to one of your clients, the name is a link straight to that client's profile. |
| Subject | The rendered subject line of the email (truncated if long). |
| Event | The identifier of the event that triggered the send (for example the invoice-paid or order-confirmation event). A dash appears for messages with no associated event. |
| Date | When the message was created. If it was sent, a second line shows the time it was sent. |
| Actions | A 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, pagination controls at the bottom show Showing X to Y of Z, a Page X of Y indicator, and previous/next arrow buttons.
Inspecting a single message
Click the View Details (eye) icon on any row to open the Email Details window. It shows:
- Status
- The current delivery status of this message.
- Attempts
- How many delivery attempts have been made against the maximum allowed (for example
1 / 3). This tells you at a glance whether a failure is a first try or a repeated one. - Recipient
- The email address the message was addressed to.
- Event
- The triggering event, or Manual if the message was not tied to an automatic event.
- Subject
- The full subject line.
- Error
- Shown only when there is a problem — a red panel containing the exact error message returned during sending.
- HTML Content
- A live preview of the rendered email body exactly as the recipient would have received it.
Close the window with the X in its top-right corner.
Retrying a failed message
- Filter to Failed using the status card or dropdown to find messages that did not go out.
- Open View Details to read the error and confirm the cause (for example a bad address, an authentication problem, or a temporary provider outage).
- Once the underlying issue is resolved, click the Retry (circular arrow) button on the failed row to queue the message for another delivery attempt. The button spins while the retry is being submitted.
Retry only appears on rows whose status is Failed. Sent, Bounced, Pending and Queued rows do not offer a retry, because they either already succeeded or are still in progress. A Bounced result usually means the address itself is invalid, so retrying without correcting the address will fail again.
Tips and gotchas
The Event column is the fastest way to correlate one customer-visible action with every email it produced. If a client complains they got several emails at once for a single transaction, scan by event to see exactly which messages fired and why.
The status cards count only the last 24 hours, so an older message may not be reflected in those tiles even though it still appears in the table. Use the search box or status dropdown to look further back rather than relying on the card counts.
A high number of Failed or Bounced messages usually points to a provider or sending-configuration problem rather than individual addresses. Open a few failed rows, read the Error text, and review your email provider settings before retrying in bulk.