Operator guideENnewslettercampaignslist

Email Newsletters / Campaigns

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

Reader view

Clean portal guidance

This page keeps the operator explanation, field and action descriptions, and screenshots visible without exposing repo paths, raw sidecars, or editorial-only implementation details.

Narrative content

Page body

What this page shows

This is the main campaign-program list for newsletter operations. Operators use it to find a campaign, confirm whether it is active, inspect schedule state, and open the full program editor.

How the page is organized

  • the header action starts a new program
  • the filters accordion stages name, status, active state, day of week, and creation-date filters until the operator presses Search
  • the main table shows the campaign identity, schedule summary, activation state, and the edit entrypoint

Important operator meanings

  • Status shows the current newsletter-service processing state, not a local FE-only badge
  • Is Active tells you whether the campaign is enabled to run
  • Scheduled Date and Created At are shown in UTC on this grid
  • Clicking the program Name and clicking the pencil icon both open the same program editor route

Known caveats

  • The route contains sibling tabs for Distribution Lists and Send Logs; those are documented separately because they have different actions and meanings.
  • The list only opens the program editor. It does not expose a direct send-now action from the grid.
  • Date presets are FE conveniences for building UTC filter ranges before the request is sent through the newsletter proxy.
  • Created To (UTC) is normalized to the end of the selected day (23:59:59 UTC) even though the control is rendered as a date-time picker.
  • Search applies the current draft filters; typing or choosing values in the accordion does not re-query the grid until Search runs.
Calculation notes

Calculations

calculation

Staged filter apply

Verification
verified_fe_only
Logic
The filter accordion keeps separate draft and applied state for `Name`, `Status`, `Is Active`, `Day of Week`, `Created From`, and `Created To`., Editing filter controls does not re-query the grid immediately., `Search` copies the draft state into the applied query state and resets pagination to page `0`.
calculation

Reset clears draft and applied filters

Verification
verified_fe_only
Logic
`Reset` clears both the visible draft values and the currently applied request values., `Reset` also clears `Date Range Preset` and resets pagination to page `0`.
calculation

Date preset population

Verification
verified_fe_only
Logic
`Date Range Preset` only populates the draft `Created From` and `Created To` values., Changing the preset does not affect the backend query until `Search` is pressed., Manual changes to either date picker clear the selected preset.
calculation

Created To end-of-day normalization

Verification
verified_fe_only
Logic
The FE normalizes `Created To (UTC)` to `23:59:59` on the selected day., This happens even though the control is displayed as a date-time picker.
calculation

Status pill coloring

Verification
verified_fe_only
Logic
`DONE` renders as a success pill., `ERROR` renders as an error pill., All other status values render as an info pill.
calculation

Active pill labeling

Verification
verified_fe_only
Logic
`is_active = true` renders as `ACTIVE`., `is_active = false` renders as `NO ACTIVE`.
calculation

Duplicate navigation entrypoints

Verification
verified_fe_only
Logic
Clicking the `Name` button and clicking the `Edit` icon both navigate to `/email-newsletters/program/:id`., The table does not expose a second detail-only route.
Grid columns

Columns

field

ID

Internal newsletter program identifier.

Visual Type
grid-column
field

Name

Human-readable campaign program name. Clicking it opens the editor.

Visual Type
link
field

Type

Whether the program is `ONE_TIME` or `WEEKLY`.

Visual Type
badge
field

Status

Current processing state reported by the newsletter backend.

Visual Type
badge
field

Day

Weekday used for recurring programs.

Visual Type
grid-column
field

Time

Planned send time for recurring programs.

Visual Type
grid-column
field

Scheduled Date

UTC date-time for one-time execution.

Visual Type
datetime
field

Is Active

Whether the campaign remains enabled to run.

Visual Type
badge
Caveats
The FE badge text is `ACTIVE` or `NO ACTIVE`, not a raw boolean.
field

Created At

UTC creation timestamp for the program.

Visual Type
datetime
Filter dictionary

Filters

field

Name

Filters newsletter programs by program name.

Type
text
Affects
list_results
field

Status

Narrows the grid to one backend campaign status such as `SCHEDULED`, `IN_PROGRESS`, or `DONE`.

Type
select
Affects
list_results
field

Is Active

Filters the list by campaigns that are enabled or disabled.

Type
select
Affects
list_results
field

Day of Week

Narrows recurring weekly programs by scheduled weekday.

Type
select
Affects
list_results
field

Created From

Lower bound for program creation time in UTC.

Type
datetime
Affects
list_results
field

Created To (UTC)

Upper bound for program creation time in UTC.

Type
datetime
Affects
list_results
Caveats
The FE normalizes the selected value to the end of the chosen day before it is applied.
Operational notes

Notes

item

FE list requests go through the backoffice newsletter proxy, not directly to `gs-admin-backend`.

item

The proxy resolves `newsletterURL` and `newsletterMerchantKey` from core settings with a 3 second timeout before it forwards the call.

item

`CampaignListView` uses staged draft filters and applies them only when `Search` copies them into the query state.

item

`Reset` clears both the draft filter widgets and the already applied query state.

item

`Created To (UTC)` is normalized to end-of-day before the applied request is built.

item

Clicking the program name and clicking the edit icon both navigate to `/email-newsletters/program/:id`.

item

Campaign list status and active state come from the downstream newsletter-service contract.

Related references

Related pages

pageEmail Newsletters

Operator workspace for newsletter campaigns, distribution lists, and send-log review through the backoffice newsletter proxy.

pageEmail Newsletters / Program

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

pageActivity Tag Rules / List

Main inventory for activity-driven tag rules, with search, activity and status filters, grouped rows, clone, edit, and run actions.

pageAffiliate Deals / List

Searchable table of affiliate deal rows with PID filter, create action, dashboard shortcut, and edit/delete row actions.

pageAffiliate Payment Settings / List

Affiliate payment settings inventory page for reviewing configured rows and opening saved records.

pageAffiliate Settings / List

Affiliate inventory list used to review saved affiliates and open detail or report flows.