Skip to content

Contacts Import and Preference Center

Tyler Hatfield edited this page Jul 13, 2026 · 1 revision

Contacts Import & Preference Center

Manage subscriber lists, customize contact schema properties, perform batch imports, and enable self-service subscription centers.


🗂️ Subscriber Lists & Custom Schemas

You can create distinct subscriber mailing lists. Each list has its own schema:

  • Default Fields: Email, Name, and Status.
  • Custom Fields: Define custom attributes (e.g. company, location, gender), control whether they are required during signup, and rearrange their visual order in forms.

📥 Delimiter-Selectable CSV Importer

To import subscribers from a CSV file:

  1. Navigate to Subscriber Lists -> CSV Import.
  2. Select your file and configure the file options:
    • Delimiter Choice: Select Comma ,, Semicolon ;, or Vertical Bar |.
    • Initial Status Mapping: Choose any of the five subscriber statuses (active, unsubscribed, pending, bounced, or complained) to apply to the imported records.
  3. Map your CSV headers to target fields (including custom fields).
  4. Launch the importer to process records in the background.

🧹 List Hygiene Resolver

Ensure database quality and protect your domain reputation using the built-in Clean List utility:

  • PolyPress performs concurrent DNS lookup queries to verify if each contact's email domain contains active MX or A records.
  • Upon completion, the dashboard displays invalid domains and allows administrators to batch unsubscribe invalid contacts.

🎛️ Subscription Preference Center

Each subscriber receives a unique preference center link mapped to the {{unsubscribe_url}} merge tag.

Instead of immediately unsubscribing, users are directed to a preference page:

  • Scoping: PolyPress fetches and lists all active lists under the tenant.
  • Toggles: Subscribers can check/uncheck checkboxes to self-manage list subscriptions.
  • Custom Confirmation Screen: Configure custom HTML messages to display to subscribers upon updating their preferences.

Clone this wiki locally