Skip to main content
Beta Feature: Email tracking is currently in beta and available on paid plans only. Features and behavior may change before general availability. Contact support to request early access.

Overview

Email tracking lets you measure engagement by detecting when recipients open your emails and click links. Tracking is configured at the route level, giving you granular control over which emails are tracked. Key features:
  • Open tracking - Know when recipients view your emails
  • Click tracking - Track which links recipients click
  • Bot detection - Filter out automated opens and clicks from analytics
  • Webhook events - Receive real-time notifications for engagement

How It Works

Open Tracking

When open tracking is enabled, Lettermint automatically injects a transparent 1x1 pixel image before the closing </body> tag of HTML emails. When the recipient’s email client loads this image, we record an open event.

Click Tracking

When click tracking is enabled, Lettermint rewrites links in your email to route through our tracking domain (t.ltrmnt.com). When a recipient clicks a link:
  1. The request hits our tracking server
  2. We record the click event with timestamp and link URL
  3. The recipient is immediately redirected to the original destination
Both tracking methods use secure, signed tokens that expire after 30 days to protect recipient privacy.

Configuration

Tracking is configured per-route in your project settings. This allows you to:
  • Enable tracking only for marketing/broadcast routes
  • Keep transactional emails tracking-free for simplicity
  • Test tracking on specific routes before wider rollout

Enabling via Dashboard

  1. Navigate to your project in the dashboard
  2. Go to Routes and select your route
  3. In Route Settings, toggle Track Opens and/or Track Clicks
  4. Save your changes

Enabling via API

Use the Team API to configure tracking programmatically:
curl -X PATCH https://api.lettermint.co/v1/routes/{route_id} \
  -H "Authorization: Bearer {team_api_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "track_opens": true,
    "track_clicks": true
  }'

Privacy & Compliance

Lettermint is designed with privacy in mind. Important considerations for GDPR and other privacy regulations:
  • Tracking disabled by default - You must explicitly enable tracking per route
  • No IP address storage - We do not store recipient IP addresses or derive location data
  • Privacy policy disclosure - Mention email tracking in your privacy policy
  • Recipient opt-out - Consider offering recipients a way to opt out of tracked emails
  • Marketing consent - For marketing/broadcast emails, ensure you have explicit opt-in consent before enabling tracking

Bot Detection

Not all opens and clicks come from humans. Email security scanners, link preview bots, and privacy proxies can trigger tracking events. Lettermint automatically detects these automated interactions on best-effort basis and flags them in webhook events. Each tracking event includes:
  • bot.detected - Boolean indicating if the interaction appears automated
  • bot.probability - Confidence score (0-100) for the bot detection
  • first_open / first_click - Whether this is the first time this recipient engaged
  • device_type - Device category: desktop, mobile, tablet
  • client_type - Client category: browser, email_client, etc.
  • client_name - Specific client: Chrome, Safari, Outlook, etc.
See the Open Tracking and Click Tracking pages for detailed bot detection information.

Webhook Events

When tracking events occur, Lettermint sends webhook notifications:
  • message.opened - Recipient opened the email
  • message.clicked - Recipient clicked a link
Configure webhooks on your route to receive these events. See Webhook Events for payload details.

Viewing Metrics

Track engagement metrics in your dashboard:
  1. Navigate to your project
  2. View route-level or message-level analytics
  3. See open rates, click rates, and engagement over time
Bot interactions are filtered from aggregate metrics by default, giving you accurate human engagement data.

Limitations

  • HTML emails only - Open tracking requires HTML content; plain-text emails cannot be tracked
  • Token expiration - Tracking tokens expire after 30 days; events after expiration are not recorded
  • Privacy proxies - Some email clients (Apple Mail Privacy Protection, Hey) pre-fetch images, affecting open accuracy
  • Corporate security - Link scanners may pre-click links, though bot detection filters most of these

FAQ

Both tracking methods can have minor deliverability implications:
  • Click tracking - Rewritten links route through our tracking domain (t.ltrmnt.com). Some aggressive spam filters flag redirect links, though impact is minimal for established senders.
  • Open tracking - The 1x1 pixel can trigger image preloading warnings in some clients, particularly Gmail. This may slightly increase spam filter scrutiny.
  • Domain reputation - Our tracking domain maintains high deliverability standards to minimize impact.
For critical transactional emails (password resets, 2FA codes), consider keeping tracking disabled to maximize deliverability.
It depends on your use case:
  • Marketing/broadcast emails - Yes, tracking provides valuable engagement metrics
  • Order confirmations, receipts - Usually safe to enable
  • Password resets, 2FA, security alerts - Consider disabling to ensure maximum deliverability
Use route-level configuration to enable tracking selectively.
Yes! Custom tracking domains are on our roadmap and planned for release at the end of Q1. This will allow you to use your own domain (e.g., track.yourdomain.com) for tracking links instead of t.ltrmnt.com, providing a more branded experience for your recipients.

Next Steps