How to Add an HTML Email Signature to Apple Mail
Apple Mail has no “paste HTML” option — the manual method means editing Mail's signature files by hand. It works, but it's fragile. Here's the honest walkthrough, then the shortcut.
Step by step
Get your signature as HTML
Export it from a designer or generator as a self-contained HTML fragment. Any images must be hosted (absolute https:// URLs) — local image paths will break for every recipient.
Create a placeholder signature
In Mail → Settings → Signatures, create a new signature and type recognizable placeholder text (e.g. “REPLACE-ME”). Assign it to your account.
Quit Mail completely
⌘Q — Mail rewrites signature files on quit, so it must not be running while you edit.
Find the signature file
With iCloud Drive enabled for Mail: ~/Library/Mobile Documents/com~apple~mail/Data/V…/Signatures. Without iCloud: ~/Library/Mail/V…/MailData/Signatures. Look for the newest .mailsignature file — open it and confirm it contains your placeholder text.
Replace the body
Open the file in a text editor. Keep the header lines at the top (Content-Transfer-Encoding, Content-Type, Message-Id) — replace everything inside/below the <body> with your HTML.
Protect the file
If you're NOT using iCloud Drive for Mail, select the file in Finder → ⌘I → check Locked, so Mail doesn't overwrite your edit. (With iCloud Drive, skip locking — it can conflict with syncing.)
Reopen Mail and test
The placeholder signature now renders your HTML. Compose a message, send yourself a test, and check it in Gmail or Outlook too.
One click instead of seven fragile steps
Autograph writes the finished signature directly into Apple Mail's signature store — the same mechanism, done safely — with hosted images, a live preview, and templates to start from.
Download Autograph free See the templatesCommon questions
My edited signature reverted — why?
Mail rewrote the file. Either it was running while you edited, or the file wasn't locked (non-iCloud setups). Redo the edit with Mail quit, then lock the file.
Do images need to be online?
Yes — recipients' mail clients load signature images from the web. Anything referencing a file on your Mac shows as broken for everyone else. Autograph hosts your photo/logo automatically.
Will this survive macOS updates?
Not always — major updates can create a new V-folder and re-provision signatures. Keep a copy of your HTML, or use Autograph, which re-installs in one click.