Skip to main content
Email notifications can be tailored in two places: the CometChat dashboard (no-code) and your delivery provider (e.g., SendGrid). Use the dashboard to manage eligibility, and payload inclusion; use your provider to shape subjects/bodies and branding.

​
What you can customize (via CometChat Dashboard)

  • Eligibility & throttling (Preferences): unread-only toggle, per-conversation delay, daily caps, per-conversation caps, override toggle for end users.
  • Payload content (Preferences → Email Payload Message Options): include message object, message metadata, sender metadata, receiver metadata.
  • Subjects (Templates): default vs privacy subject strings for 1:1 and group.
  • Templates: configure default/privacy subjects; body rendering is handled in your provider using payload fields.
  • Custom providers: point to your own webhook instead of SendGrid.

Preferences

Delivery limits, overrides, and payload inclusion toggles.

Templates

Subjects and payload shapes to render your email content.

Custom Providers

Configure SendGrid or webhooks for email delivery.

​
What you can customize (via SendGrid or your provider)

  • Subjects: use the payload subject or build your own from senderDetails / groupDetails / messages.length.
  • Body content: loop over messages to show previews; add CTAs, links, and branding; optionally hide content for privacy.
  • Branding: layout, logo, colors, typography handled entirely in your template.
  • Data mapping: map payload fields to template variables (see Email Templates for payload shapes and a SendGrid example).

​
Example flow

  1. In CometChat dashboard, enable Email Notifications and set preferences.
  2. Configure a SendGrid provider (or custom provider webhook).
  3. In your SendGrid Dynamic Template, map variables to the payload (subject, recipientName, senderName, unreadCount, messages[]).
  4. Adjust subjects/privacy as needed in the dashboard templates.