How to Add an HTML Email Signature in Apple Mail (macOS & iOS)

Apple Mail for macOS and iOS enjoys a sterling reputation for adhering closely to WebKit rendering standards. Unlike Microsoft Outlook, Apple Mail supports modern CSS, WebKit box models, and transparent PNG rendering with high fidelity.

However, getting Apple Mail to accept and retain custom raw HTML without flattening your carefully tuned font styles or overwriting your code with its internal default font can be maddeningly counter-intuitive.

In this comprehensive tutorial, we cover the exact methods for installing an HTML email signature in Apple Mail on macOS (including the advanced .mailsignature file lock technique) and iOS (iPhone & iPad).

The macOS Apple Mail "Font Override" Trap

Before doing anything else in Apple Mail on your Mac, there is one crucial checkbox setting that ruins 90% of pasted signatures:

Method 1: The Quick Clipboard Paste Method (macOS)

For clean signatures generated by CraftMySig, the direct rich clipboard paste is often 100% effective once the default font override is disabled:

1. In CraftMySig, click "Copy Signature".
2. In Apple Mail on macOS, open Mail > Settings > Signatures.
3. In the left column, select the email account you want to associate the signature with (or "All Signatures").
4. Click the + (Plus) button to create a new placeholder signature.
5. Give your signature a clear name in the middle column.
6. In the right-hand preview panel, select all existing placeholder text and delete it.
7. Press Cmd + V to paste your copied signature.
8. Ensure "Always match my default message font" is unchecked.
9. Assign your new signature as the default for your selected account in the bottom dropdown.
10. Compose a new email to verify that your layout and images render perfectly.

Method 2: The Advanced Locked .mailsignature Method (macOS)

If your signature contains complex nested tables, custom CSS classes, or dynamic images that Apple Mail tries to modify, you can use the direct filesystem injection method:

1. In Apple Mail, create a temporary blank signature named TempSig and close Apple Mail completely (Cmd + Q).
2. Open Finder, press Cmd + Shift + G, and paste this path:

   ~/Library/Mail/V10/MailData/Signatures/

   (Note: Depending on your macOS version, the folder may be V9, V10, or V11).
3. Locate the newest file ending in .mailsignature. Open it with TextEdit.
4. You will see a top metadata block containing mime headers:

   Content-Transfer-Encoding: 7bit
   Content-Type: text/html;
     charset=us-ascii
   Message-Id: <...>
   Mime-Version: 1.0

5. Keep the top metadata lines untouched! Select everything below the metadata block and replace it with your raw CraftMySig HTML code. Save the file.
6. The Critical Step: Lock the file! Right-click the .mailsignature file, select Get Info (Cmd + I), and check the "Locked" checkbox. (Or in Terminal run: chflags uchg filename.mailsignature).
7. Reopen Apple Mail. Because the file is locked, Apple Mail cannot overwrite or strip your raw HTML tables!

Installing on iPhone & iPad (iOS)

On mobile iOS devices, Apple does not provide a raw HTML editor, but supports rich clipboard pasting:

1. Open CraftMySig on your iPhone Safari or desktop browser and copy the signature. If copying from desktop, you can email the signature to yourself.
2. In your received email, highlight the entire signature and tap Copy.
3. Go to your iPhone Settings > Mail > Signature.
4. Select whether you want the signature for "All Accounts" or "Per Account".
5. Tap inside the box, delete default text, and tap Paste.
6. Perform the Shake Trick: Physically shake your iPhone until the "Undo Change Attributes" prompt appears. Tap Undo!

Apple Mail Troubleshooting Matrix