How to install a professional HTML signature in Apple Mail, step by step

Why Apple Mail won't accept HTML directly

In Gmail you can copy a visual signature from the browser and paste it straight into settings. Apple Mail, on the other hand, manages signatures via internal files with the extension .mailsignature.

If you paste HTML code directly into Mail's signature editor, it will usually appear as plain text or lose much of its design. That's why the correct method is to create an empty signature first and then edit the file Apple Mail generated.

What you need to create your HTML signature in Apple Mail

• A Mac with the Mail app set up.
• A ready-made HTML signature.
• The signature image uploaded to a public URL, for example on WordPress.
• A text editor like Visual Studio Code, Sublime Text or TextEdit in plain-text mode.

Step 1: create a new signature in Apple Mail

Open the Mail app on your Mac and go to:

Select the email account where you want to install the signature and click the + button to create a new signature.

You can name it, for example:

Inside the signature content write a temporary text that's easy to find. For example:

Step 2: locate Apple Mail's signatures folder

Now you need to find the internal file that Apple Mail created for that signature.

Open Finder and press:

The 'Go to Folder' window will open Go to the folder. Paste this path:

Inside you'll see one or more folders named like:

• V9
• V10
• V11
• V12

Enter the folder with the highest number, as it usually corresponds to the current Mail version on your Mac.

Then open:

The full path is usually similar to this:

Step 3: find the correct signature file

Inside the Signatures folder you'll see several files with the extension:

If you have several signatures created, there will be multiple files. To know which one corresponds to the signature you just created, open the files with a text editor and search for the temporary text you wrote earlier:

The file containing that text is the one you must edit.

Step 4: edit the .mailsignature file

When you open the file you'll see a structure similar to this:

Content-Transfer-Encoding: quoted-printable
Content-Type: text/html;
	charset=utf-8
Message-Id: <...>
Mime-Version: 1.0

<body>
FIRMA_TEMPORAL
</body>

What you must do is delete only the HTML content that appears below those headers and replace it with your HTML signature.

Step 5: paste your HTML signature

Now paste your signature's HTML beneath the headers. A basic example structure would be:

<body>
  <table cellpadding="0" cellspacing="0" border="0" style="font-family: Arial, Helvetica, sans-serif;">
    <tr>
      <td>
        <strong>Your name</strong><br>
        Professional service<br>
        <a href="mailto:[email protected]">[email protected]</a>
      </td>
    </tr>
  </table>
</body>

In a professional signature you can include:

• Name and job title.
• Photo or logo.
• Service buttons.
• Links to the website.
• Email link.
• Telephone number.
• Contact button.
• Legal text or confidentiality notice.

Step 6: save the file and lock it

Once you've pasted the HTML signature, save the file.

Then, in Finder, right-click the .mailsignature file and choose:

Check the box:

Step 7: open Apple Mail and test the signature

Open Apple Mail again and create a new message.

In the signature selector, choose the signature you created. If everything is correct, you should see the signature with its layout, links, colours, image and buttons.

Common problems when installing an HTML signature in Apple Mail

The signature appears as HTML code

This usually happens when HTML is pasted directly into Apple Mail's visual signature editor. The solution is to edit the .mailsignature file as explained in this guide.

The signature image doesn't appear

Check that the image is uploaded to a public URL and that you can open it in the browser. If the image is on your computer, other users may not be able to see it.

Apple Mail erases the design

Make sure you've quit Mail before editing the file and have locked the .mailsignature file after saving it.

Rounded corners or some styles don't look the same

Email clients don't interpret HTML the same way as a browser. That's why it's best to use tables, inline styles and simple layouts. Apple Mail usually respects HTML fairly well, but some visual details may vary in other email clients.

The signature looks too large

It's recommended that an email signature is visually appealing but not excessive. If it includes many blocks, buttons or long legal texts, it can be useful to create a compact version for everyday use.

Tips for creating a professional HTML signature

• Use a lightweight image, preferably in JPG or WebP format.
• Don't use complicated external fonts.
• Avoid external CSS. Inline styles are better.
• Use tables instead of complex layouts with flexbox or grid.
• Include useful links, not too many.
• Check the signature by sending yourself a test email.
• Check how it looks on mobile.