Most people don’t need to touch the file system to get an HTML signature working in Apple Mail. Turn off “Always match my default message font” in Signature preferences, then paste a rendered version of your HTML signature (not the raw code) into the signature editor. If that doesn’t hold after restarting Mail, the manual .mailsignature file method further down is the fallback.

What You Need Before You Start

  • Your HTML signature file, ready to open in Safari
  • Any images in the signature hosted online with absolute URLs
  • Apple Mail on Mac
  • A few minutes, since Apple Mail sometimes needs a restart for signature changes to stick

The Simple Method: Paste a Rendered Signature

  1. Open your HTML signature file in Safari specifically. Other browsers can copy formatting inconsistently for this step.
  2. Select the entire signature (Cmd + A), then copy it (Cmd + C).
  3. Open Apple Mail and go to Mail → Settings → Signatures (or Mail → Preferences → Signatures on older macOS versions).
    Older versions of macOS (Monterey and earlier) label this menu Mail → Preferences rather than Mail → Settings, but the Signatures tab and every step inside it work identically. If your menu says Preferences instead of Settings, keep following the same steps.
  4. Select the email account you want the signature on, then click the plus (+) icon to add a new signature.
  5. Name the signature.
  6. Before pasting, untick “Always match my default message font.” Skipping this step is the most common reason a pasted signature loses its formatting.
  7. Click into the signature content box and paste (Cmd + V).
  8. Close the Settings window. Apple Mail saves automatically.
  9. Quit and reopen Mail, then compose a test email to check the signature holds.

The Manual Method: Editing the Signature File Directly

If the signature loses formatting or won’t save properly using the method above, this fallback edits Apple Mail’s signature file directly.

  1. In Apple Mail, go to Settings → Signatures and create a new signature with any placeholder text. This generates the file you’ll replace.
  2. Quit Apple Mail completely.
  3. Open Finder, click Go in the menu bar, hold Option, and select Library.
  4. Navigate to Mail → V10 → MailData → Signatures (the version number after “V” may differ on your system).
  5. Find the newest .mailsignature file, which corresponds to the placeholder you just created.
  6. Open it with TextEdit.
  7. Replace the content after the header with your HTML signature code.
  8. Save the file.
  9. Right-click the file, choose Get Info, and tick Locked. This stops Apple Mail overwriting it when it next syncs signatures.
  10. Reopen Apple Mail and check the signature in a new message.

Troubleshooting HTML Signatures in Apple Mail

Images show as a blue box with a question mark, or don’t load

This is usually Apple Mail’s privacy protection blocking remote image loading, not a broken signature. Check Mail → Settings → Privacy and review the image-loading and tracking prevention options. It can also mean the image URL itself is broken or not publicly accessible, so confirm the image loads correctly in a browser first.

Signature loses formatting after pasting

Confirm “Always match my default message font” is switched off before pasting. If it’s already off and formatting still breaks, switch to the manual .mailsignature file method, which gives more reliable results for complex layouts.

Signature reverts or disappears after quitting Mail

This typically means the signature file was overwritten because it wasn’t locked. If you’ve used the manual file method, double check the Locked box is ticked on the .mailsignature file in Finder.

Signature works in Apple Mail but looks broken to recipients

Apple Mail’s own rendering can be more forgiving than what recipients see, especially in Gmail’s web view or Outlook. Test by sending to an account on a different email provider, not just to yourself in the same Apple Mail account.

FAQs

Can I paste raw HTML code directly into Apple Mail's signature editor?

No. Apple Mail’s signature editor doesn’t accept raw HTML source, similar to Outlook for Mac. You need to render the HTML in a browser first (Safari is the most reliable), then copy and paste the rendered result as formatted content.

Apple Mail periodically resyncs its signature files, which can overwrite manual edits. Locking the file (via Get Info in Finder) prevents Mail from replacing your edited version.

The method is different on each. This guide covers Mac. iPhone requires a separate workaround since iOS Mail’s signature field is plain text only.

This is usually a hosting or privacy setting issue on the recipient’s end, or an image that isn’t reliably publicly accessible. Confirm the image URL loads in an incognito browser window with no login required.

If you manage email for a whole team and want signatures that hold up across Mac, Windows, and mobile without this much manual fiddling, get in touch and we can set it up properly once.

Yes, and tables are the most reliable way to lay out an Apple Mail signature. Apple Mail’s rendering engine handles table-based layouts more predictably than CSS positioning, particularly for anything with a logo alongside contact details.