HTML · CSS · JS Sig API

HTML and CSS email signatures

Build a signature around content that survives changes in presentation. HTML supplies structure and links; CSS shapes the appearance. Keep the exported signature compact and readable, then test it through the editor and email clients that will actually handle it.

Separate the website from the email output

A website preview can use JavaScript, animations, and interactive controls to help someone choose a design. The signature exported into an email should not rely on those features. Produce static HTML with the contact information and formatting already present.

Do not copy the surrounding website’s navigation, script tags, framework classes, or animation dependencies into the signature. A Tailwind-powered builder may generate the output, but its stylesheet is not automatically part of the recipient’s email. Keep optional visual effects on the website and make the email version useful on its own.

Choose CSS from observed support

Use a small styling vocabulary: readable typography, explicit spacing, sensible image dimensions, and clear links. Inline essential presentation where it suits the installation workflow, while recognizing that an editor may transform the supplied HTML. Keep a usable fallback when optional styling is absent.

Google’s Gmail CSS reference lists supported selectors and properties and notes that unsupported CSS may be ignored. This is documentation for Gmail, not a universal email standard. Test the clients you support and avoid promising identical layout from a single implementation’s feature list.

Let the content determine the structure

Put the sender’s name and role first, followed by the contact methods and one useful destination. Keep the reading order logical before adding columns or decorative separators. Allow realistic names, translated titles, and longer organization names to wrap without overlapping neighboring content.

Choose a modest layout that your tests support. If you use a table for presentation, keep it simple and avoid unnecessary nesting. Give adjacent links enough space and use descriptive labels. The signature planning guide helps decide which fields belong in the design before styling begins.

Make images helpful and optional

Keep essential information as text. Use a logo or portrait to complement identity and provide alternative text when an image communicates something meaningful. Specify practical display dimensions and check that the image remains sharp enough at its intended size without being unnecessarily large.

Gmail’s image settings guide explains that recipients can require permission before external images appear. Your signature should remain understandable in that state. Use approved image hosting, avoid sensitive information in asset URLs, and remember that a decorative image and an analytics endpoint serve different purposes.

Test the whole round trip

Check the source preview, the installed signature, and a delivered message. These stages can differ, so keep a small test record identifying the client, version where available, installation method, and observed result.

  • Test narrow screens, long contact details, and zoomed text.
  • Review light and dark presentation with the clients you support.
  • Disable external images and inspect the reading order.
  • Reply and forward to catch duplication and unexpected wrapping.
  • Verify every contact link and remove unused markup.

For generated signatures, apply the same checks to representative records in the rendering workflow before distributing an update.

Common questions

Can I run JavaScript inside the exported signature?

Design the exported signature without JavaScript. Use browser scripts for a website editor or preview, then export the static content and styling required for the email itself. Do not make contact information depend on script execution.

Does using inline CSS guarantee compatibility?

No. Inline styling is one implementation choice, not a guarantee. Property support, the signature editor, content sanitization, and the recipient’s application can affect the result. Verify the combinations your team actually uses.

Your next good idea starts here

Make your sign-off count.

Explore the design details, platform choices, and workflows behind a better signature.

Find your starting point