Operator guideENnewsletterdistribution-lists

Email Newsletters / Distribution Lists

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

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 tab has two operator zones on the same surface:

  • an upload card used to preview CSV files, create a list when needed, and attach contacts
  • a paginated inventory table of reusable distribution lists

The upload card is documented in depth by the dedicated Distribution Lists / Upload Flow unit. This relation page is the parent surface that hosts that flow and the reusable list table below it.

Important caveats

  • The visible Attach to List (optional) dropdown uses an empty value labelled Create new list. Leaving it unchanged keeps the flow on the create-new-list branch.
  • The table has both top and bottom pagination controls on the current FE surface.
  • The visible table column is Size, not Contacts.
  • Clicking Name opens the read-only standalone detail route.
  • Clicking the pencil icon opens the standalone edit route outside the newsletter tabbed page.
Grid columns

Columns

field

ID

Internal distribution-list identifier.

Visual Type
grid-column
field

Name

User-facing name of the recipient list.

Visual Type
link
Caveats
Clicking the name opens the standalone detail route for that list.
field

Size

Current number of contacts attached to the list.

Visual Type
grid-column
Operational notes

Notes

item

Distribution-list operations are newsletter-service calls routed through the backoffice proxy.

item

The proxy still depends on core settings for `newsletterURL` and `newsletterMerchantKey`.

item

The tab-level component uses direct `axios` calls for preview, upload, create-list, and add-contacts steps rather than the auxiliary `useUploadCsvToDistributionList` hook.

item

The same parent surface also owns both top and bottom pagination controls and the `File Result` dialog.

Related references

Related pages

pageDistribution Lists

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

pageDistribution Lists / Detail

Read-only detail workspace for one distribution list and the contacts currently attached to it.

pageDistribution Lists / Form

Rename flow for an existing distribution list plus the implicit create-a-list branch triggered from the CSV upload card.

pageDistribution Lists / Contacts

Read-only contact grid attached to one newsletter distribution list.

pageDistribution Lists / Upload Flow

CSV preview and upload flow used to validate files, create a target list when needed, and attach contacts.

pageEmail Newsletters

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