Operator guideEN

Distribution Lists

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

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 module is for

Use Distribution Lists to manage reusable recipient lists for newsletter programs.

Operators use this area to:

  • inspect one list and its current contacts
  • rename an existing list
  • upload a CSV file and attach contacts to an existing list
  • upload a CSV file and let the system create a new list automatically

Main surfaces

  • Distribution Lists / Detail shows one list and the contacts currently attached to it.
  • Distribution Lists / Form documents the rename flow and the implicit create-on-upload branch.
  • Distribution Lists / Contacts explains the read-only contacts grid shown on detail and edit pages.
  • Distribution Lists / Upload Flow explains the CSV preview, file upload, new-list creation, and add-contacts chain used from the newsletter tab.

Important caveats

  • There is no standalone backoffice list route for distribution lists. Operators reach the main inventory through Email Newsletters on the Distribution Lists tab.
  • The standalone routes that exist today are only:
    • /distribution-lists/[id]
    • /distribution-lists/edit/[id]
  • A new list can be created without a dedicated create page. If the upload card has no target list selected, the FE first creates a list and then attaches parsed contacts to it.

Operational ownership

  • The backoffice UI owns the visible tabs, buttons, standalone detail route, and standalone rename route.
  • The newsletter proxy forwards list, file, and add-contacts requests to the newsletter service.
  • The proxy needs these configured values before it can forward requests:
    • newsletterURL
    • newsletterMerchantKey
  • Missing newsletter configuration blocks this module even when the CRM page itself loads.
  • Distribution-list records, CSV file processing, and add-contacts behavior are owned by the newsletter service.
More help

Related pages

Distribution Lists / Detail

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

Distribution Lists / Form

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

Email Newsletters / Distribution Lists

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

Distribution Lists / Contacts

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

Distribution Lists / Upload Flow

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

Email Newsletters

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