Skip to Content
EmailExchangeEmail SignaturesTest Signature

Test Signature

Send test emails to preview how your email signatures render across different email clients and devices. Testing ensures signatures display correctly before deploying to the organization.

Note: Always test signatures in multiple email clients before deploying. Rendering varies significantly between Outlook desktop, Outlook web, Gmail, and mobile clients.

Test Options

Send Test Email

Send a sample email with the signature applied:

  1. Select template — Choose the signature template to test.
  2. Select test user — Choose a user whose Azure AD data will populate the dynamic variables.
  3. Enter recipients — Add email addresses to receive the test (internal and external).
  4. Send — Deliver the test email with the signature applied.

Preview Mode

View how the signature renders without sending:

  • Desktop preview — Simulates Outlook desktop rendering
  • Web preview — Simulates Outlook on the web rendering
  • Mobile preview — Simulates mobile email client rendering
  • Plain text preview — Shows the plain text fallback version

Testing Checklist

Visual Verification

  • Logo displays correctly and is properly sized
  • Brand colors render as expected
  • Text is readable and properly formatted
  • Social media icons link to correct profiles
  • Layout is not broken or misaligned

Variable Resolution

  • Display name populates correctly
  • Job title and department appear
  • Email address is accurate
  • Phone numbers are formatted properly
  • Company name and address are complete

Cross-Client Testing

ClientPriorityNotes
Outlook DesktopHighMost common business client
Outlook Web (OWA)HighBrowser-based access
Outlook MobileMediumiOS and Android apps
GmailMediumCommon external recipient
Apple MailLowmacOS and iOS default
  • All links are clickable and point to correct URLs
  • Social media icons link to correct profiles
  • Campaign banner links to intended landing page
  • Email address link opens compose window

Troubleshooting

Images Not Displaying

  • Verify image URLs are publicly accessible (not behind authentication)
  • Check that images are hosted on HTTPS
  • Ensure image dimensions are specified in the HTML

Layout Breaking

  • Use table-based layout instead of CSS flexbox or grid
  • Apply inline CSS styles (not external stylesheets)
  • Avoid CSS properties not supported by Outlook (e.g., max-width)

Variables Not Resolving

  • Verify Azure AD attributes are populated for the test user
  • Check variable syntax (%%VariableName%%)
  • Ensure the transport rule condition matches the test message

Best Practices

  • Test before every deployment — Always test after making template changes.
  • Use real user data — Test with actual user accounts to verify variable resolution.
  • Test external recipients — Send to Gmail and other external services to check rendering.
  • Document results — Keep a record of which clients were tested and any issues found.

API Reference

POST /api/exchange/signatures/test Send test email with signature

GET /api/exchange/signatures/test/preview Get signature preview rendering

GET /api/exchange/signatures/test/history View past test results

Last updated on