Skip to main content

​
Overview

Migma includes a complete audience management system for managing subscribers, creating tags for organization, building dynamic segments, and tracking engagement. Manage everything from the Contacts page or Audience page in your project dashboard.

Manage Subscribers

Store and organize contact information with custom fields

Tag-Based Organization

Create tags to categorize and segment your audience

Analytics & Stats

Track subscriber growth and engagement

​
Key Features

​
Subscriber Management

  • Contact Database
  • Subscription Status
  • Tags & Organization
  • Dynamic Audiences
Store subscriber information:Standard fields:
  • Email (required, unique per project)
  • Name
  • Country (ISO codes: US, CA, GB, etc.)
  • Language (ISO codes: en, en-US, es, fr, etc.)
  • Company
  • Role/Job title
Custom fields:
  • Flexible object storage
  • Any additional data you need
  • Searchable and filterable

​
Accessing Audience Features

​
Contacts Page

Navigate to: /contacts in your project The main contact management interface with:
  • Subscriber table - Sortable, searchable, filterable
  • Add subscriber - Single contact add
  • Bulk import - CSV file upload
  • Tag management - Create, edit, view tags
  • Export - Download contacts as CSV
  • Analytics - Subscriber growth and stats

​
Audience Page

Alternative interface at: /audience Tab-based organization:
  • Subscribers tab - Data table with all contacts
  • Tags tab - Grid view of all tags
  • Segments tab - Saved dynamic audiences
  • Send email to segments
  • Import/export functionality
Both pages access the same data - choose your preferred interface!

​
Subscriber Statistics

​
Dashboard Metrics

View at-a-glance stats: 
Total Subscribers: 1,247

By Status:
├─ Subscribed: 1,189 (95.3%)
├─ Unsubscribed: 45 (3.6%)
├─ Non-subscribed: 10 (0.8%)
└─ Bounced: 3 (0.2%)

Growth (Last 30 Days):
├─ New subscribers: +142
├─ Unsubscribed: -45
└─ Net growth: +97 (+8.4%)

Email Activity (Last 30 Days):
└─ Emails sent: 3,456

​
Analytics by Period

Track trends over time: Available periods:
  • Day - Last 24 hours
  • Week - Last 7 days
  • Month - Last 30 days
Metrics tracked:
  • New subscribers added
  • Unsubscribe count
  • Bounced/cleaned count
  • Total emails sent
  • Subscriber growth trend

​
Tag System

​
Creating & Managing Tags

Tags help organize your audience:
1

Create Tag

On Contacts or Audience page:
  1. Click “Tags” section
  2. Click “Create Tag”
  3. Enter tag details:
    • Name (e.g., “VIP”, “Newsletter”, “Product Launch”)
    • Color (visual identification)
    • Description (team reference)
2

Apply to Subscribers

Add tags to contacts:Single subscriber:
  • Edit subscriber
  • Select tags from dropdown
  • Save
Multiple subscribers:
  • Select contacts (checkboxes)
  • Bulk action → Add tag
  • Choose tag to apply
3

View by Tag

Filter subscribers by tag:
  • Click tag in filter sidebar
  • Or search by tag name
  • See all subscribers with that tag
  • Shows subscriber count per tag
4

Manage Tags

Edit or delete tags:
  • Click tag in Tags section
  • Edit name, color, description
  • Delete tag (removes from all subscribers)
  • View subscriber count

​
Tag Best Practices

Create naming conventions:Examples:
source-website
source-webinar
source-referral

status-lead
status-customer
status-churned

interest-javascript
interest-python
interest-devops
Prefix categories for easy organization
Visual organization with colors:
  • Blue - Source tags (website, webinar, etc.)
  • Green - Status tags (active, customer, etc.)
  • Purple - Interest tags (topics, products, etc.)
  • Red - Action tags (at-risk, bounced, etc.)
Quick visual identification in subscriber lists
Document tag purpose:Example:
Tag: webinar-2024-q1
Description: Attended our Q1 2024 product webinar
Use: Send webinar follow-up sequence, product launch emails
Helps team understand tag meaning and usage

​
Dynamic Audiences (Segments)

​
Creating Audiences

Build filtered subscriber groups:
1

Navigate to Audiences

Go to Audience page → Segments tab
2

Create Audience

Click “Create Audience”Provide:
  • Name (e.g., “Engaged VIP Customers”)
  • Description (optional)
3

Define Filters

Add filter conditions:By Tags:
Has ALL tags: [VIP, Customer]
Does NOT have tag: [Churned]
By Status:
Status: subscribed
By Custom Fields:
Company Size greater than 100
Industry = "SaaS"
Combine with AND/OR logic
4

Preview Count

See how many subscribers match:
This audience contains: 47 subscribers
Updates automatically as you adjust filters
5

Save Audience

Save for reuse in email campaignsAuto-updating: Subscriber count updates as contacts match/unmatch criteria

​
Using Audiences

Send emails to saved audiences:
  1. Create or select email
  2. Choose “Send to Audience”
  3. Select saved audience
  4. Send to all subscribers in that segment
Benefits:
  • No manual list updates needed
  • Always current subscribers
  • Reusable for recurring campaigns
  • Clear targeting criteria

​
Preference Categories

Map tags to user-facing preferences:

​
Setup Preference Center

Create preference categories:
1

Define Categories

Create preference categories that map to tags:Example categories:
  • “Weekly Newsletter” → maps to tag newsletter
  • “Product Updates” → maps to tag product-updates
  • “Promotional Emails” → maps to tag promotions
2

Configure Display

For each category:
  • Name (user-facing)
  • Description
  • Associated tag
  • Active/inactive status
  • Display order
3

Subscribers Choose

When subscribers visit their preference center:
  • See all categories
  • Toggle on/off per category
  • Updates their tags automatically
Learn more: Preference Center Guide →

​
Data Validation

​
Email Validation

Automatic validation on import and API:
Format validation - RFC compliant email format
Lowercase normalization - All emails stored lowercase
Duplicate detection - Unique per project
Bounce tracking - Invalid addresses marked

​
Country & Language Codes

Supported standards: Countries:
  • ISO 3166-1 alpha-2 codes
  • Examples: US, CA, GB, DE, FR, JP, AU
  • Validation on input
Languages:
  • ISO 639-1 language codes
  • BCP 47 language tags supported
  • Examples: en, en-US, es, es-MX, fr, de, ja
  • Validation on input

​
Search & Filtering

​
Search Capabilities

Find subscribers quickly: Search by:
  • Email address (exact or partial)
  • Name (first or last)
  • Company
  • Custom field values
Examples: 
@gmail.com          → All Gmail users
john                → All "john" in name or email
Acme Corp           → Company name match
California          → Custom field "state" value

​
Advanced Filtering

Combine multiple filters:
  • By Status
  • By Tag
  • By Custom Field
  • Combined
Status = subscribed
→ Shows only active subscribers

​
Import & Export

​
CSV Import

Bulk import subscribers: Supported format: 
email,name,country,language,company,role
[email protected],John Doe,US,en,Acme Corp,CEO
[email protected],Jane Smith,CA,en,Tech Inc,CTO
Features:
  • Drag & drop or paste CSV
  • Auto-tag imported contacts
  • Set status (subscribed/unsubscribed)
  • Custom field mapping
  • Error reporting
Full CSV Import Guide →

​
Export Subscribers

Download contacts: Export formats:
  • CSV (spreadsheet-compatible)
  • JSON (API/developer-friendly)
Export options:
  • All subscribers
  • Filtered subset
  • Selected subscribers only
Includes:
  • All standard fields
  • Tags
  • Custom fields
  • Preference URLs (optional)

​
Compliance Features

​
Unsubscribe Management

Automatic handling:
Token-based unsubscribe - Unique URL per subscriber
Instant processing - Immediately marked unsubscribed
Cannot re-subscribe - Without explicit consent
Timestamp tracking - When they unsubscribed
Respects preferences - Tag-specific or global unsubscribe

​
Preference Center

Public subscriber management:
  • No login required - Token-based access
  • View subscription status - Per preference category
  • Update preferences - Toggle on/off
  • Unsubscribe options - Specific categories or all
  • Privacy - Secure token access
Learn more →

​
API Access

​
Programmatic Management

Automate subscriber operations: 
// Add subscriber via API
POST /api/v1/subscribers
{
  "email": "[email protected]",
  "name": "John Doe",
  "tags": ["newsletter", "vip"],
  "customFields": {
    "company": "Acme Corp",
    "industry": "SaaS"
  }
}

// List subscribers with filters
GET /api/v1/subscribers?tags=newsletter&status=subscribed&limit=100

// Update subscriber
PATCH /api/subscribers/:id
{
  "tags": ["newsletter", "vip", "engaged"]
}

// Unsubscribe
POST /api/v1/subscribers/unsubscribe
{
  "email": "[email protected]"
}
Full API documentation: API Reference →

​
Getting Started Checklist

1

Navigate to Contacts

Go to /contacts in your project dashboard
2

Import Initial Subscribers

If you have existing contacts:
  • Click “Import CSV”
  • Upload or paste CSV data
  • Map columns and import
Or add manually:
  • Click “Add Subscriber”
  • Enter email and details
  • Save
3

Create Tags

Organize your audience:
  • Create 3-5 initial tags
  • Examples: Newsletter, VIP, Lead, Customer
  • Apply to subscribers
4

Set Up Preference Categories

Map tags to preferences:
  • Create preference categories
  • Link to tags
  • Enable subscriber self-management
5

Create First Audience

Build a saved segment:
  • Create audience with filters
  • Test subscriber count
  • Save for email campaigns
6

Send Test Email

Verify everything works:
  • Send email to small audience
  • Check delivery
  • Review analytics

​
Best Practices

Regular maintenance:Monthly:
  • Review bounced addresses
  • Check unsubscribe reasons
  • Remove invalid emails
Quarterly:
  • Tag inactive subscribers
  • Re-engagement campaign
  • Clean non-responsive contacts
Benefits:
  • Better deliverability
  • Lower costs
  • Accurate metrics
Effective tagging:Do:
  • Consistent naming conventions
  • Prefix categories (source-, status-, interest-)
  • Document tag purposes
  • Color code by type
Don’t:
  • Too many tags (creates confusion)
  • Overlapping tag meanings
  • Single-use tags (use audiences instead)
Keep it simple and organized
GDPR and compliance:Always:
  • Get clear consent before adding
  • Honor unsubscribe requests immediately
  • Provide easy preference management
  • Secure subscriber data
  • Allow data export on request
Never:
  • Add contacts without permission
  • Re-subscribe unsubscribed users
  • Share/sell subscriber data
  • Ignore privacy requests
Compliance Guide →
Better targeting = better results:Segment by:
  • Engagement level (active vs inactive)
  • Lifecycle stage (lead, customer, advocate)
  • Interests (product categories, topics)
  • Demographics (location, industry, company size)
  • Behavior (opened, clicked, purchased)
Benefits:
  • Higher open rates
  • Better click rates
  • Lower unsubscribes
  • More conversions

​
Next Steps

Manage Contacts

Add and organize subscribers

CSV Upload

Bulk import contacts

Send Emails

Send to your audience

Preference Center

Subscription management

​
Need Help?

Watch Tutorial

Audience management walkthrough

Join Discord

Get audience building tips

Contact Support

Help with audience setup

API Docs

Subscriber API reference