Operator guideEN

Email Newsletters / Send Logs

Delivery-log search surface for newsletter sends, with campaign, email, status, and date filters.

How to use this guide

Start with the main guide

Follow the explanation and examples first. Extra definitions and formulas are available below when you need them.

What this page shows

This tab is the read-only delivery-history surface for newsletter sends. Operators use it to confirm whether a campaign reached a contact, failed, bounced, was opened, or is still in another delivery state.

How operators use it

  • narrow one log slice by campaign, contact, email, template, status, and date ranges
  • compare recent sends from one campaign against older delivery events on the same tab
  • inspect whether the delivery pipeline reached SENT, DELIVERED, OPENED, BOUNCED, FAILED, or another warning-state status
  • review the stored HTML body snippet and bounce reason without reopening the parent campaign editor

Important caveats

  • The log search is read-only on this tab.
  • Sent At and Created At filters are range filters. The To pickers are normalized to the end of the selected day before the search is applied.
  • The tab exposes top and bottom pagination plus page-size selection, but no row-level Info, Edit, or retry action is currently rendered.
  • The filter accordion turns its title into Filters (Active) when any draft filter value is populated.
  • Draft filter edits do not re-query the grid until Search applies them.
  • Campaign filter options come from the newsletter program list, so a missing or unavailable program list can also affect the Campaign selector.
  • Contact Name and Template Name are useful row context, but their filters are not currently aligned with the displayed row fields. Use Campaign, Email, Status, and date filters for dependable narrowing.
More details

Definitions and formulas

Open only the section you need. The relevant section opens automatically when you request help for a specific item on screen.

Calculations10 topicsOpen details

Staged filter apply

Logic
The tab keeps separate draft and applied state for campaign, contact, email, template, status, `Sent At`, and `Created At`., Editing filter widgets does not re-query the grid immediately., `Search` copies the draft values into the applied request state and resets pagination to page `0`.

Reset clears draft and applied filters

Logic
`Reset` clears all draft filter inputs, both date presets, and all applied query values., `Reset` also resets pagination to page `0`.

Date preset population

Logic
`SentAt Preset` and `CreatedAt Preset` populate only the draft date values., Manual edits to the related date pickers clear the active preset., Preset changes do not affect the applied request until `Search` is pressed.

End-of-day normalization

Logic
`Sent At To (UTC)` and `Created At To (UTC)` are normalized to end-of-day on the selected date before serialization., The applied request sends date values as UTC ISO timestamps, so timezone conversion can shift the exact serialized boundary if the picker value was not already UTC.

Offset pagination

Logic
`useGetSendLogs` derives `offset` from `pageNo` and `limit` when no explicit offset is provided., Changing rows per page resets the visible page back to `0`., Top and bottom paginators share the same local page and rows-per-page state., The table data source applies the requested limit and offset.

Send-log query serialization

Logic
Empty, null, and undefined filter values are not applied to the Send Logs request., Applied filter names are normalized before the request is sent., The result set is tenant-scoped, limited by the selected page size, offset by the selected page, and returned newest first.

Association filter caveat

Logic
Send-log rows expose `contact_name` from joined contact first name and `template_name` from joined template title., Current filtering for Contact Name and Template Name does not align with those displayed row fields., Operators should rely on Campaign, Email, Status, Sent At, and Created At filters for dependable narrowing until those two filters are aligned.

Campaign filter options

Logic
The Campaign filter options are loaded from the campaign/config list using `pageNo = 1` and `limit = 9999`., Option labels use campaign name when present, otherwise `Campaign, This is a shared campaign list request, not a dedicated Send Logs campaign lookup.

Status pill rendering

Logic
Missing or empty status values render as `UNKNOWN` with a warning pill., `SENT` and `DELIVERED` render as success pills., `BOUNCED` and `FAILED` render as error pills., `OPENED` renders as an info pill., Other statuses are uppercased and rendered as warning pills.

Commented row actions

Logic
The implementation still contains a commented row-action block for edit/info-style navigation., No row-level action buttons are rendered on the current verified surface.
Columns12 topicsOpen details

ID

Internal newsletter send-log record identifier.

Visual Type
grid-column

Campaign

Program that generated the delivery event.

Visual Type
grid-column

Campaign Type

Campaign category returned with the send-log record.

Visual Type
grid-column

Contact Name

Recipient display name recorded with the log.

Visual Type
grid-column

Language

Locale or language code tied to the delivery record.

Visual Type
grid-column

Email

Recipient email address used for the send.

Visual Type
grid-column

Template Name

Template used for the delivery record.

Visual Type
grid-column

Status

Delivery result or lifecycle state.

Visual Type
badge
Caveats
Missing status values are shown as `UNKNOWN`., `SENT` and `DELIVERED` render as success pills., `BOUNCED` and `FAILED` render as error pills., `OPENED` renders as an info pill., Other values are uppercased and shown as warning pills.

Bounced Reason

Backend-provided bounce reason when the message could not be delivered.

Visual Type
grid-column

Body HTML

Stored HTML body preview for the sent message.

Visual Type
grid-column
Caveats
The table truncates the visible value to the first 60 characters and appends `...` when the body is longer.

Sent At

Timestamp when the message was sent.

Visual Type
datetime
Caveats
The table renders this value with the browser locale formatter rather than forcing the label to UTC.

Created At

UTC timestamp when the send-log record was created.

Visual Type
datetime
Caveats
The table renders a tooltip that explicitly states `Time in UTC zone.`
Filters11 topicsOpen details

Campaign

Narrows logs to one newsletter campaign from the full campaign option list loaded for this tab.

Type
select
Affects
list_results
Values
All campaigns, Campaign name, Campaign
Caveats
The tab loads campaign options through the newsletter config/program list, not a dedicated send-log-only campaign list., The campaign option request asks for up to 9999 campaign records.

Contact Name

Visible recipient display name for the log row.

Type
text
Affects
list_results
Caveats
The visible row value is derived from contact first name., Current filtering for this control does not align with the displayed first-name field. Use Campaign, Email, Status, Sent At, and Created At for dependable narrowing.

Email

Narrows logs by recipient email.

Type
text
Affects
list_results
Caveats
Service-side filtering uses a partial match for direct send-log email values.

Template Name

Visible template title for the delivery record.

Type
text
Affects
list_results
Caveats
The visible row value is derived from template title., Current filtering for this control does not align with the displayed template-title field. Use Campaign, Email, Status, Sent At, and Created At for dependable narrowing.

Status

Narrows logs by delivery state such as `SENT`, `FAILED`, or `BOUNCED`.

Type
select
Affects
list_results
Values
All, blank option, SENT, SENDING, DELIVERED, OPENED, BOUNCED, UNSUBSCRIBED, SPAM, FAILED

SentAt Preset

Quickly applies one predefined UTC range for `Sent At`.

Type
preset-select
Affects
list_results
Values
Custom Range, Today, Yesterday, Last 7 Days, Previous Week, Previous Month, Current Year, Previous Year
Caveats
Presets do not re-query the grid until Search is pressed., Manual date changes clear the selected preset.

Sent At From (UTC)

Lower boundary for the sent-at range sent with the send-log request.

Type
datetime
Affects
list_results
Caveats
Editing this value changes draft filter state first; Search is required to apply it.

Sent At To (UTC)

Upper boundary for the sent-at range sent with the send-log request.

Type
datetime
Affects
list_results
Caveats
The UI normalizes the selected value to the end of the chosen day before it serializes the request timestamp., Timezone conversion can shift the exact serialized boundary if the picker value was not already UTC., Editing this value changes draft filter state first; Search is required to apply it.

CreatedAt Preset

Quickly applies one predefined UTC range for `Created At`.

Type
preset-select
Affects
list_results
Values
Custom Range, Today, Yesterday, Last 7 Days, Previous Week, Previous Month, Current Year, Previous Year
Caveats
Presets do not re-query the grid until Search is pressed., Manual date changes clear the selected preset.

Created At From (UTC)

Lower boundary for the record creation range sent with the send-log request.

Type
datetime
Affects
list_results
Caveats
Editing this value changes draft filter state first; Search is required to apply it.

Created At To (UTC)

Upper boundary for the record creation range sent with the send-log request.

Type
datetime
Affects
list_results
Caveats
The UI normalizes the selected value to the end of the chosen day before it serializes the request timestamp., Timezone conversion can shift the exact serialized boundary if the picker value was not already UTC., Editing this value changes draft filter state first; Search is required to apply it.
More help

Related pages

Distribution Lists

Operator documentation for newsletter recipient lists, including detail, rename, contacts inspection, and CSV upload or attach flows.

Email Newsletters

Operator workspace for newsletter campaigns, distribution lists, and send-log review.

Email Newsletters / Campaigns

Main newsletter program inventory with filters, status badges, active-state checks, and edit navigation.

Email Newsletters / Distribution Lists

Reusable contact-list inventory with CSV preview, upload, create, and add-contacts actions.

Email Newsletters / Program

Full create and edit workflow for one newsletter campaign program, including recipients, templates, notifications, coupons, and delivery settings.

Actions / Merchant Balance

Operator workspace for reviewing the merchant-balance transaction journal and creating manual debit or credit adjustments.