Skip to content

Channel Settings Specification

Channel Settings allow channel owners and editors to configure metadata, translation settings, bounce cleaning rules, and access control.


1. Channel Welcome Page (/settings/welcome)

  • Component Tag: <listserv-settings-welcome>
  • Route Path: /settings/welcome
Settings Welcome Screen
Channel Settings Welcome Overview

2. Channel Configuration (/settings/channel)

  • Component Tag: <listserv-settings-channel>
  • Route Path: /settings/channel
Channel Configuration Form Screen
Channel Configuration panel for metadata, contact info, and rate limits

Schema Fields (ChannelS)

FieldTypeDescription
titleStringPublic display title of the channel
descriptionStringChannel description displayed on subscribe form
adminContactObject{ name, email, phone? } inserted into mail headers/footers
rateLimitObject{ maxPerHour: number } limiting submissions per sender (default: 5)
privacyWarningStringLegal privacy notice rendered on public pages and mail footers

3. Active Languages (/settings/language)

  • Component Tag: <listserv-settings-language>
  • Route Path: /settings/language
Active Languages Settings Screen
Active Languages Configuration interface

Behavior

  • Renders switches for languages configured in Customer Settings.
  • When enabled, approved broadcasts are automatically translated into these target ISO 639-1 languages before sending.

4. Bounce Handling (/settings/bounce)

  • Component Tag: <listserv-settings-bounce>
  • Route Path: /settings/bounce
Bounce Handling Settings Screen
Bounce Handling thresholds and manual list cleaning button

Configuration Fields

SettingTypeDescription
Automatic Cleaning<md-switch>Toggles automatic subscriber deactivation on bounce webhooks
Bounce ThresholdNumberNumber of permanent failures before account deactivation (default: 3)
Clean List ButtonButtonTriggers on-demand list reconciliation against Mailgun bounce logs

5. User Access Management (/settings/user)

  • Component Tag: <listserv-settings-user>
  • Route Path: /settings/user
User Access Management Screen
User Access Management interface displaying team roles
Full User Management Interface
Full User Access View showing channel ownership, team member list, and role assignments

Section Controls & Fields

Control / FieldTypeDescription
Listserv Admin MembersHeaderOverview describing role permissions and secretariat team linkage
Ownership SectionProfile CardIdentifies primary channel owner (playwright-a11y@preignition.org)
Modify OwnershipButtonDialogue trigger to transfer channel ownership
Add MembersButtonAction to invite new team members or assign access roles
Member List / Pending InviteTabsToggle between active team members and outstanding invitations
Member TableData TableGrid listing user names, emails, and assigned role chips (owner, admin, editor)

Access Roles

RolePermissions
OwnerFull channel administration, settings management, and user access delegation
EditorDraft broadcasts, moderate community posts, manage subscribers, dispatch emails
GuestRead-only access to broadcast archives and analytics