Newsletters Module - User Manual

Introduction

The Newsletters module allows bands to create and send email newsletters to subscribers. You can manage subscriber lists, create campaigns, and track email delivery.

Getting Started

Accessing Newsletters

  1. Select a band from the band selector
  2. Click "Newsletters" in the main menu (under "Band")
  3. You'll see a list of all newsletter lists for the selected band

Permissions

Your access to newsletters depends on your user level and permissions:

  • View - You can see newsletters and lists
  • Edit - You can create and modify campaigns
  • Delete - You can remove campaigns (if granted)
  • Send - You can send newsletters
  • SMTP View/Edit - You can manage email settings

Managing Subscriber Lists

Creating a List

  1. Click "Add List" or "New List"
  2. Fill in list details:
    • Name (required) - List name
    • Description (optional) - List description
  3. Click "Create List"

Adding Subscribers

  1. Go to a list's subscriber page
  2. Click "Add Subscriber"
  3. Enter subscriber information:
    • Email (required) - Subscriber email address
    • Name (optional) - Subscriber name
  4. Click "Add"

Managing Subscribers

  • View - See all subscribers in a list
  • Edit - Update subscriber information
  • Delete - Remove subscribers
  • Import - Bulk import subscribers (if available)

Creating Campaigns

Creating a New Campaign

  1. Go to a subscriber list
  2. Click "Create Campaign" or "New Campaign"
  3. Fill in campaign details:
    • Subject (required) - Email subject line
    • Content (required) - Email body (HTML supported)
    • From Name (optional) - Sender name
    • From Email (optional) - Sender email
  4. Click "Create Campaign"

Editing Campaigns

  1. Go to the campaign list
  2. Click "Edit" next to a campaign
  3. Modify campaign details
  4. Click "Save Changes"

Campaign Content

Campaigns support:

  • HTML Content - Rich text formatting
  • Plain Text - Simple text version
  • Variables - Personalization (e.g., {name}, {email})

Sending Newsletters

Sending a Campaign

  1. Go to the campaign list
  2. Click "Send" next to a campaign
  3. Review sending options:
    • Send Now - Send immediately
    • Schedule - Send at a specific time (if available)
  4. Click "Send" or "Schedule"

Sending Queue

Newsletters are sent via a queue system:

  • Campaigns are added to the queue
  • Emails are sent in batches
  • Progress is tracked
  • Failed sends are retried

Sending Limits

Your package may have limits on:

  • Maximum Lists - Number of subscriber lists
  • Maximum Subscribers - Subscribers per list
  • Sending Rate - Emails per hour/day

SMTP Settings

Configuring SMTP

  1. Go to "Settings" in the Newsletters module
  2. Click "SMTP Settings" or "Add SMTP"
  3. Enter SMTP configuration:
    • Host - SMTP server address
    • Port - SMTP port (usually 587 or 465)
    • Username - SMTP username
    • Password - SMTP password
    • Encryption - TLS or SSL
    • From Email - Default sender email
    • From Name - Default sender name
  4. Click "Save" or "Test Connection"

Testing SMTP

  1. Go to SMTP settings
  2. Click "Test Connection"
  3. The system will:
    • Verify SMTP credentials
    • Send a test email
    • Report connection status

Multiple SMTP Accounts

You can configure multiple SMTP accounts:

  • Use different accounts for different lists
  • Set default SMTP account
  • Switch between accounts as needed

Newsletter Settings

General Settings

  1. Go to "Settings" in the Newsletters module
  2. Configure:
    • Default From Email - Default sender
    • Default From Name - Default sender name
    • Reply-To Email - Reply address
    • Unsubscribe Link - Automatic unsubscribe handling

Campaign Settings

  • Sending Rate - Emails per batch
  • Retry Failed - Retry failed sends
  • Bounce Handling - Handle bounced emails

Tips and Best Practices

List Management

  1. Organize lists - Create separate lists for different audiences
  2. Keep lists clean - Remove invalid emails regularly
  3. Respect privacy - Follow email regulations (GDPR, CAN-SPAM)
  4. Get consent - Only add subscribers who opted in

Campaign Creation

  1. Clear subject lines - Make subjects descriptive
  2. Mobile-friendly - Test on mobile devices
  3. Personalize - Use variables for personalization
  4. Test before sending - Send test emails first

Sending Best Practices

  1. Send at optimal times - Consider time zones
  2. Don't spam - Respect sending limits
  3. Monitor delivery - Check bounce rates
  4. Track engagement - Monitor open/click rates (if available)

Troubleshooting

Sending Issues

"Emails not sending"

  • Check SMTP settings
  • Verify SMTP credentials
  • Test SMTP connection
  • Check sending queue status

"High bounce rate"

  • Clean subscriber lists
  • Verify email addresses
  • Check SMTP reputation
  • Review email content

Access Issues

"Can't create campaigns"

  • Check edit permission
  • Verify list exists
  • Check package limits

Frequently Asked Questions

Q: How many subscribers can I have?
A: This depends on your package limits. Check your package settings for maximum subscribers per list.

Q: Can I import subscribers from a file?
A: Import functionality may be available. Check the subscriber management page for import options.

Q: How do I handle unsubscribes?
A: The system automatically handles unsubscribes. Unsubscribe links are added to emails automatically.

Q: Can I schedule campaigns?
A: Scheduling may be available depending on your package. Check campaign sending options.

Q: What email providers can I use?
A: Any SMTP-compatible email provider works. Common options include Gmail, Outlook, SendGrid, Mailgun.

Q: How do I track email opens/clicks?
A: Tracking features may be available in future versions. Check campaign settings for analytics.

Last updated: January 2025

nGage Engine 1.44.1 © 2026