An HTML email signature breaks when it relies on modern web code that email clients strip or ignore. To keep it intact, build the layout with tables, write every style inline, give each image a width, height and alt text, host images at full https addresses, animate only with GIFs, and keep the whole thing small.
Email HTML is closer to the web of the early 2000s than the web of today. A signature that looks perfect in a browser preview can lose its columns in classic Outlook, show broken images in Gmail or collapse into a stack of plain links on a phone. The six rules below prevent the most common problems.
Why HTML email signatures break
Every email client has its own rendering engine, and most are far stricter than a web browser. Classic Outlook for Windows renders email with Microsoft Word's engine, which ignores much of modern CSS. Gmail removes linked stylesheets and some tags outright. The new Outlook and Outlook on the web are more capable, but you never get to choose which app your recipient opens.
Signature editors add another layer. When you paste a design into the signature box in Gmail or Outlook, the editor can rewrite your HTML, and anything it doesn't understand may be dropped. Code that survives both the editor and the strictest inbox is code that follows the rules below.
Layout and styling rules
Rule 1: Use tables for layout
Flexbox and grid are unreliable in email. Can I email, which tracks CSS support across inboxes, lists display:flex as unsupported in every version of classic Outlook for Windows it has tested, and grid fares no better. Nested tables are verbose, but they're the one layout system every client renders consistently.
In practice that means one outer table for the whole signature, a cell for each block (photo, details, call to action) and fixed pixel widths rather than percentages. Put spacing on table cells as padding: classic Outlook only supports padding on table cells, according to Can I email's padding data.
Rule 2: Inline every style
Many clients and signature editors drop style blocks, linked stylesheets and class names. Gmail, for example, ignores linked stylesheets and doesn't support style blocks inside the email body (Can I email). Put styling directly on each element with the style attribute so nothing depends on a stylesheet surviving.
Stick to properties with broad support: font-family, font-size, color, line-height, border and padding on cells. Use a web-safe font stack such as Arial, Helvetica, sans-serif. Custom web fonts aren't supported in Gmail (Can I email), so a fancy font usually falls back to a default anyway.
Image rules
Rule 3: Give every image a width, height and alt text
Set width and height as HTML attributes, in plain numbers, on every image. Classic Outlook for Windows ignores the CSS width property on images (Can I email), so without the attribute an image can display at its full file size. For a sharp, high-resolution logo, that can mean twice as big as you intended.
Alt text matters because images don't always load. Microsoft says Outlook is configured by default to block automatic picture downloads, so some recipients see your signature before its images. Short alt text, such as your company name on the logo, keeps it readable until they load. Contact details should always be real text, never part of an image.
Rule 4: Host images at absolute URLs
Relative paths and images attached to the email are a common source of broken signatures and red-X placeholders. Embedding images as base64 data isn't a reliable fix either: Gmail doesn't display base64 images, and classic Outlook for Windows support is patchy (Can I email). Host images on a reliable CDN and reference them by full https URL.
Use formats every client understands: PNG for logos and icons, JPG for photos and GIF for animation. Skip WebP and SVG. Classic Outlook for Windows doesn't display WebP, older versions don't display SVG, and Gmail converts SVG to a flat PNG.
Animation and file size rules
Rule 5: No scripts, forms, video or CSS animation
These are either stripped or ignored. Gmail replaces video tags entirely (Can I email), and CSS animation doesn't run in Gmail, classic Outlook for Windows or Outlook.com, even though Apple Mail plays it (Can I email). Hover effects are just as unreliable, and scripts don't run in email at all.
If you want motion, use an animated GIF. It's just an image, so anywhere images load, the signature appears, and in clients that support animation, it moves. Make sure the first frame looks finished on its own, because classic Outlook 2007 to 2019 shows only that frame (Can I email).
Rule 6: Keep it small
Your signature rides along on every reply, and in a long thread it can appear many times over. Gmail clips messages whose code passes 102KB, according to Litmus, hiding the rest behind a View entire message link. Gmail also caps the signature itself at 10,000 characters, images included.
Lean table code, compressed images, modest dimensions and short GIF loops keep you clear of both limits and help the signature load quickly on a phone connection.
Quick reference: what works where
| Technique | Classic Outlook (Windows) | Gmail | Apple Mail |
|---|---|---|---|
| Tables with inline styles | Yes | Yes | Yes |
| Flexbox or grid layout | No | Mostly | Yes |
| CSS animation | No | No | Yes |
| Animated GIF | First frame only (2007–2019) | Yes | Yes |
| Custom web fonts | No | No | Yes |
| Rounded corners (border-radius) | No | Yes | Yes |
| Base64-embedded images | Patchy | No | Yes |
Data from the Can I email support tables. The new Outlook for Windows and Outlook on the web handle more than classic Outlook does, but design for the strictest client your recipients are likely to use.
How to test your HTML email signature
- 1Send a test email to a Gmail address, an Outlook address and an Apple Mail inbox on an iPhone or Mac.
- 2Open each one on a computer and on a phone. Check that columns hold, links work and nothing wraps awkwardly.
- 3Reply and forward once, then check the signature still looks right further down the thread.
- 4In classic Outlook, look at the message before downloading pictures to check your alt text, then download them and confirm any GIF's first frame looks complete.
- 5Switch one client to dark mode and make sure your logo and text are still visible.
If you'd rather not hand-code nested tables, you can build an HTML email signature free and watch the preview update as you type. Browse the signature examples first if you want ideas for the layout.
Frequently asked questions
Why does my HTML email signature look different in Outlook?
Classic Outlook for Windows renders email with Microsoft Word's engine, which ignores much modern CSS. Table-based layouts with inline styles and fixed image sizes are the most reliable way to get consistent results.
Can I use CSS classes in an email signature?
It's risky. Many email clients and signature editors strip style blocks and class names when you paste, send or reply, so the styling disappears. Write styles inline on each element with the style attribute so they travel with the HTML wherever it goes.
Should email signature images be attached or hosted?
Hosted. Attached or embedded images often show up as attachments, broken placeholders or not at all, since Gmail doesn't display base64-embedded images. Upload each image to a reliable host and reference it by a full https web address instead.
Can I paste raw HTML code into Gmail's signature box?
No. Gmail's signature editor accepts formatted content, not source code. The usual method is to open the finished signature in a browser, copy the rendered version and paste it into the signature box. Keep it under Gmail's 10,000-character limit, which includes images pasted directly into the box.
Ready to build yours?
Pick a template, add your details and watch it animate live. Free to build and preview, pay once when you're ready to install.
Build my signature for free



