Mailfois
Guides / Why Outlook breaks your HTML email
Guide

Why Outlook breaks your HTML email (and how to fix it)

Classic Outlook for Windows draws email with Microsoft Word's engine, so unclosed tags, CSS widths, background images, rounded buttons and web fonts break there first. The common breakages, why they happen, and the fix for each.

In short: classic Outlook for Windows (Outlook 2007 to 2019 and classic Outlook for Microsoft 365) draws HTML email with Microsoft Word's rendering engine, not a web browser's. Word ignores much of modern CSS and is far less forgiving of broken HTML. So the emails that break in Outlook usually have one of a handful of causes: unclosed or mismatched table tags, widths set only in CSS, background images, rounded or padded link buttons, web fonts without a fallback, or layout built with divs, flexbox or floats. Build the structure with tables, put width attributes on tables and images, close every tag, and use Outlook-only code (<!--[if mso]>) for buttons and backgrounds.

The new Outlook for Windows uses a browser engine, so it shows email much like Outlook on the web. But classic Outlook is still in use, particularly on work computers. Your email platform's report of opens by email client will tell you how many of your readers do.

Why it's different

Web browsers, Gmail and Apple Mail are built to show web pages. They support modern CSS and quietly repair broken HTML: a missing </td> usually still looks fine. Classic Outlook's Word engine was built to display documents. It supports a narrower set of HTML and CSS and handles mistakes differently, so the same broken HTML that looks right in your browser preview can push columns out of line, drop content or stretch the email in Outlook.

The common breakages, and the fix

What you see in OutlookThe usual causeThe fix
Columns out of line, content missing or pushed downAn unclosed or mismatched <table>, <tr> or <td>Close every tag, and check the counts of opening and closing table tags match
The email stretches across the whole windowWidth set only with max-width in CSSWrap the email in a fixed-width table for Outlook only (a "ghost table")
Huge imagesNo width attribute on the imageAdd width="600" (or the display width) as an attribute, not just in CSS
A background image doesn't showClassic Outlook ignores CSS background imagesUse VML inside <!--[if mso]> for the background, with a solid background colour as a fallback
Square, thin or unclickable buttonsPadding and border-radius on a link are ignoredUse a table-cell button or a VML button for Outlook
Text in Times New RomanA web font with no fallback, or a fallback Outlook skipsPut a safe fallback first for Outlook (for example Arial)
Thin white lines between sectionsTable cells of odd heights, or images with no display:blockSet display:block on images, and matching background colours on cells
Spacing that's wrongMargins and padding on <div> and <p>Put spacing on table cells instead
Everything slightly too bigWindows set to more than 100% display scalingAdd the Office settings block that fixes pixels per inch, and width attributes everywhere

Unclosed tags: the most common cause

Many Outlook breakages come down to a single tag that was never closed, usually after hand-editing, pasting a section from another email or removing a module. Because browsers repair it, nobody notices until the Outlook test, or until a customer replies with a screenshot.

To find one:

  • Count them. The number of <table and </table> must match, and the same for <tr / </tr> and <td / </td>.
  • Validate the HTML with any HTML validator or your code editor's formatter: an unclosed tag shows up as the indentation going wrong.
  • Check edits at the seams. Problems cluster where a module was added, removed or pasted in.

Brand Guard in Mailfois flags tags left open, along with images with local addresses and outside stylesheets, before anyone approves the email.

The Outlook-only code you'll need

Conditional comments are read only by classic Outlook, so you can give it a fixed-width table while every other inbox gets your responsive layout:

<!--[if mso]><table role="presentation" width="600" align="center" cellpadding="0" cellspacing="0" border="0"><tr><td><![endif]-->
<div style="max-width:600px; margin:0 auto;">
  <!-- the email -->
</div>
<!--[if mso]></td></tr></table><![endif]-->

The same approach gives Outlook a rounded button drawn in VML, with a normal link button for everyone else:

<!--[if mso]><v:roundrect xmlns:v="urn:schemas-microsoft-com:vml" href="https://example.com" style="height:48px; v-text-anchor:middle; width:220px;" arcsize="20%" stroke="f" fillcolor="#0f7a59"><center style="color:#ffffff; font-family:Arial,sans-serif; font-size:16px; font-weight:bold;">Shop the sale</center></v:roundrect><![endif]-->
<!--[if !mso]><!--><a href="https://example.com" style="display:inline-block; background:#0f7a59; color:#ffffff; padding:14px 26px; border-radius:10px; text-decoration:none; font-family:Arial,sans-serif; font-weight:bold;">Shop the sale</a><!--<![endif]-->

For the root element, add the VML namespaces (xmlns:v="urn:schemas-microsoft-com:vml" and xmlns:o="urn:schemas-microsoft-com:office:office") so Outlook recognises them.

A checklist before every send

  • Every table, row and cell tag closed.
  • A ghost table or fixed width for classic Outlook.
  • width attributes on every table and image.
  • Buttons as table cells or VML, not padded links alone.
  • A solid background colour behind every background image.
  • A safe font first for Outlook.
  • Spacing on table cells, not margins on divs.
  • A real test in classic Outlook for Windows if your readers use it.
  • The HTML under about 90KB, so Gmail doesn't clip it (what counts toward the 102KB limit).

Questions

Why does my HTML email look broken in Outlook?

Classic Outlook for Windows draws email with Microsoft Word's engine, which supports less CSS than a browser and handles broken HTML differently. The usual causes are unclosed table tags, widths set only in CSS, background images, padded link buttons and web fonts without a fallback.

Does the new Outlook for Windows have the same problems?

Mostly not. The new Outlook for Windows uses a browser engine, so it shows email much like Outlook on the web. Classic Outlook is still in use, so check your email platform's report of email clients before dropping the Outlook-only code.

How do I find an unclosed tag in an HTML email?

Count the opening and closing tags for tables, rows and cells, which must match; run the HTML through a validator or your editor's formatter; and look closely at places where modules were added, removed or pasted in.

How do I make rounded buttons work in Outlook?

Classic Outlook ignores border-radius and padding on links. Use a VML rounded rectangle inside an Outlook-only conditional comment, with the normal link button for every other inbox.

Sources

*Checked on 9 November 2026. Microsoft is moving people from classic to new Outlook: check your own readers' email clients.*

Written by Mailfois. Mailfois is built by someone who works in email marketing and also builds apps. About Mailfois.

Find the Outlook problems before your client does.

Try Mailfois free