Forum Notifications In Plain Text — a feature discussion or integration topic from the APG vNext community forum.
APG vNext Integration Capabilities
- Authentication: ASP.NET Membership, Active Directory/LDAP, OAuth (Facebook, Twitter, Google)
- Email: Configurable SMTP, HTML templates, digest notifications, bounce handling
- Mobile: Responsive design + official Tapatalk integration from v5.5+
- Search: Built-in full-text search powered by SQL Server Full-Text Indexing
- Analytics: Google Analytics, Adsense, and third-party widget support
- CDN: Static asset CDN support configurable via admin panel
Browse the full list at Features Overview or ask in the support forum.
Forum Notification Emails in Plain Text Format in APG vNext
APG vNext sends notification emails in HTML format by default. Some mail clients, corporate email filters, or user preferences require plain text notifications. APG vNext supports both multipart (HTML + plain text fallback) and plain-text-only notification modes.
Switching to Plain Text Notifications
<!-- web.config -->
<add key="APG.Email.Format" value="PlainText" />
<!-- Options: HTML | PlainText | Multipart -->
<!-- Multipart sends both HTML and plain text versions -->Customising the Plain Text Template
-- Template file location:
/email-templates/new-reply.txt
-- Example plain text template:
Hi {MemberName},
{AuthorName} replied to your thread "{ThreadTitle}":
---
{PostExcerpt}
---
View the full reply: {ReplyUrl}
To manage your notification preferences: {PreferencesUrl}
{ForumName} | {ForumUrl}Per-Member Format Preference
<add key="APG.Email.AllowMemberFormatChoice" value="true" />
<!-- Members can choose HTML or Plain Text in Profile -> Notifications -->Why Plain Text Can Improve Deliverability
HTML emails are more likely to be flagged by spam filters than plain text emails. For transactional notifications (reply alerts, PM notifications), plain text or multipart format typically achieves 15-20% better inbox delivery rates than HTML-only.
Related Resources
Choosing Between Plain Text and HTML Notifications
Some email clients and mail servers strip HTML from incoming emails, displaying only the plain text content. APG vNext notification emails include both an HTML part and a plain text fallback in the MIME multipart structure. Email clients that render HTML display the HTML version; clients configured to display plain text display the text version. If members report receiving plain text notifications, the issue is that their email client is configured to prefer plain text — not that APG vNext is sending plain text emails. Confirm this by checking whether the sent notification email in the APG email queue shows as HTML type. Advise the member to configure their email client to prefer HTML email display, or accept that plain text display is a valid user preference that the email system correctly supports.
Designing HTML Email Templates for APG vNext
HTML email rendering differs significantly from browser HTML rendering. Email clients (Outlook, Gmail, Apple Mail, Yahoo Mail) each have their own rendering engines with varying levels of CSS and HTML support. For reliable HTML email rendering across clients, follow email-specific HTML best practices: use table-based layouts rather than CSS flexbox or grid, use inline CSS rather than stylesheet blocks (many email clients strip or ignore <style> tags), avoid background images (Outlook ignores them), and keep email width under 600px to fit mobile screens. APG vNext's default notification email templates are pre-optimised for cross-client compatibility and tested against the major email clients. When customising notification templates in Admin Panel → Email → Templates, stick to the table-based structure of the default templates and add inline CSS rather than stylesheet blocks.
Dark Mode in Email Notifications
Many members read email in dark mode, and a white-background HTML email can look jarring in a dark mode email client. APG vNext 5.5+ notification templates include a CSS media query for dark mode that switches the email background and text colours when the client is in dark mode:
@media (prefers-color-scheme: dark) {
.email-body { background: #1a1a1a !important; color: #e0e0e0 !important; }
.email-link { color: #6b9fff !important; }
}Not all email clients support the prefers-color-scheme media query — Outlook on Windows does not support it as of 2026, while Apple Mail and Gmail on iOS and Android do. Use the media query as a progressive enhancement rather than a required feature, keeping the light mode design readable and accessible as the fallback.
Notification Email Frequency and Member Preferences
Over-sending notification emails is a common reason members unsubscribe from forum notifications or mark them as spam. APG vNext allows members to configure their notification frequency preferences from their account settings: immediate (one email per event), digest (daily or weekly summary of all new activity in subscribed threads), or off (no notifications, check the forum manually). Administrators can set the default notification mode for new members and restrict which modes are available site-wide. For high-volume forums where individual thread activity can generate dozens of notifications per day, configuring the daily digest as the default (with immediate as an opt-in) significantly reduces email volume while keeping members informed. Daily digests also perform better in spam filter scoring because they generate fewer high-frequency emails from the same sending domain.
Email Notification Click Tracking
APG vNext can optionally add UTM tracking parameters to all links in notification emails, allowing Google Analytics to attribute forum visits originating from notification emails to the Email marketing channel. Configure UTM parameter values in Admin Panel → Email → Click Tracking. This helps quantify the traffic value of notification emails and supports decisions about notification frequency and content. Use UTM source consistent with your analytics setup.
Looking for more help? Browse the support forum or check the Knowledge Base.