Email Reports

HitKeep can send scheduled analytics summaries by email when SMTP is configured. Users can subscribe to a consolidated digest across the sites they can access, and site owners can subscribe to site-specific reports.

Note

Email reports require a working SMTP configuration. See Email (SMTP) in the Configuration Reference.

Settings -> Notifications lets users manage digest and per-site report subscriptions.

Two Report Types

Digest Reports

A digest bundles a summary of the sites the user can access into one scheduled email. The report uses aggregate pageview totals and links back to the dashboard for follow-up.

When saved Opportunity Recommendations are ready, they can appear inside the same daily or weekly digest. There is no separate Opportunities email to configure. The digest renders saved recommendation records with localization keys, interpolation params, route hints, score, confidence, and cited aggregate evidence. It does not start a new AI run.

Per-Site Reports

Per-site reports focus on one site and include its key metrics for the configured period.

Setup via Dashboard

1. Open Settings → Notifications in the HitKeep dashboard.
2. Toggle Weekly Digest on or off.
3. For individual sites, open Site Settings → Notifications and enable the site report.

REST API Reference

• Get report subscription settings
• Update the digest subscription
• Update a per-site report subscription

SMTP Configuration

Reports are sent via your configured SMTP server. The minimum required settings:

hitkeep \
  -mail-host="smtp.postmarkapp.com" \
  -mail-port=587 \
  -mail-username="YOUR_API_TOKEN" \
  -mail-password="YOUR_API_TOKEN" \
  -mail-from-address="analytics@your-domain.com" \
  -mail-from-name="HitKeep"

Or via environment variables:

HITKEEP_MAIL_HOST=smtp.postmarkapp.com
HITKEEP_MAIL_PORT=587
HITKEEP_MAIL_USERNAME=YOUR_API_TOKEN
HITKEEP_MAIL_PASSWORD=YOUR_API_TOKEN
HITKEEP_MAIL_FROM_ADDRESS=analytics@your-domain.com
HITKEEP_MAIL_FROM_NAME=HitKeep

Full reference: Email (SMTP).

After configuring SMTP, instance operators can use Administration → System Status → Operations → Mail to send a real test email to a specified recipient. The mail test uses the configured mail transport and records the result in the instance audit log.

Report Delivery

Reports are dispatched by the background Report Worker on a scheduled basis. The worker runs automatically as long as SMTP is configured. No cron jobs or external schedulers are needed.

Opportunity recommendations follow the same delivery path as the rest of the digest. If no saved recommendations are ready for a site, the digest omits that section.

Related

• Configuration Reference
• Opportunity Recommendations
• System Status and Settings
• Permissions & Roles
• REST API Reference

Don’t want to manage SMTP configuration, deliverability, or email templates? HitKeep Cloud → includes managed email delivery out of the box.