How to Make an HTML Signature in Apple Mail

  1. In Apple Mail, open Preferences > Signatures.

mojave-mail-preferences-1-0580b9f630b2624e3144ff2c5e1f34a0.png

2. Once open, create a new signature.

mojave-mail-preferences-2-9ad8baf6c8d5e49a833db6983a353b54.png

3. Name the signature something meaningful in the central column. Replace the signature contents on the right with some placeholder text. This text should be recognizable to you as we will use it to help identify the correct signature system file later.

mojave-mail-preferences-3-1091de37f3ba1c6bba6f74e9e58f6b3b.png

4. Ensure the Always match my default font checkbox is off

mojave-mail-preferences-4-e0edf96904fa199b9b45ad0f559e4cca.png

5. Associate the new placeholder signature with one of your email accounts by dragging its name from the second column to an email account in the first column.

mojave-mail-preferences-5-2a2599eae2908a4283de012b849c1718.png

6. If you want to setup the signature to be the default for an email account with auto-load when starting a new message, select the email account in the first column, and choose the new signature.

mojave-mail-preferences-6-ebe128353ce8b088e550568b0ca66dad.png

7. Close the Preferences window to save it, then Quit Apple Mail.

8. We are going to be using TextEdit to open code files in the following steps, so we need to ensure that it is setup properly to display the raw HTML code.

Open a TextEdit.app, found in Applications, start a new document, and open Preferences > Open and Save.

Ensure that the checkmark next to Display HTML files as HTML code instead of formatted text is ticked.

mojave-textedit-preferences-1-255aac119cb9f282192960b32f5bc2b7.png

Close the Preferences panel, and close the new document.

9. We are going to need to locate the folder containing the placeholder signature. Unfortunately, most of you are not going to be able to use Finder to get to these folders.

Apple goes to great lengths to hide these files from people as they usually contain info that is not usually editable by hand. Trying to navigate to them by clicking in Finder will usually lead you to your visible iCloud Drive folder with nowhere else to go. Don’t worry though, I will walk you through an alternative method of getting to the hidden signature files we need to work with.

The files can be in 2 different places depending on whether you are using iCloud Drive or not. You are most likely using iCloud Drive, even if you are not using an iCloud email address. Check to see if you’re using iCloud Drive by going to System Preferences > iCloud, then look to see if the iCloud Drive checkbox is ticked or not.

mojave-system-preferences-1-f4cab275a24517fca24d6387d92efd5e.png

Double-check that iCloud Drive is enabled for Mail by clicking the Options button and ensuring the checkbox next to Mail is ticked.

mojave-system-preferences-2-b0d01a2a4ba4e7654289ce4267718c39.png

If both of these checkmarks are ticked, then you are using iCloud Drive and should proceed to the next step. If not, skip ahead to step 11.

10. (You should only do this step if using iCloud Drive.)

Open Terminal.app, found in Applications > Utilities, and copy/paste the following line into the box and press enter.

ls -laht ~/Library/Mobile\ Documents/com~apple~mail/Data/V4/Signatures/
mojave-terminal-1-429ada951744e52c7ecfd7e585d0c608.png

This line tells Terminal to list all the files in this directory along with some other file info, then sort it by date. When you press enter you should see a bunch of lines, each of which corresponds to a file and some of its metadata. Look at the right side column — the file names — and notice the ones that end in .mailsignature. These are the files we are interested in working with.

If you get an error, make sure you pasted the line in exactly like shown on one line. If you still get an error, you may not be using iCloud Drive and are following the wrong step.

mojave-terminal-2-e21cec00b2eec2d0c61c866163467996.png

In the new lines that come up in Terminal after running the command, you should see a .mailsignature file that has the date and time of when you started this tutorial. This is the placeholder file. If you don’t see a file, then you may have done something wrong in a previous step, and should try again.

As mentioned above, we could normally use Finder to view these folders, but Apple has hidden access to them to prevent direct editing, something we wish to do here. If you have only 1 .mailsignature file, then this is most likely the placeholder file you created in the earlier steps. If you have more than one .mailsignature file in there, then you need to find the one you created earlier. Because this list is sorted top-down by the most recently updated, it will most likely be the top one, but you can check by opening them all and seeing their contents.

Terminal.app does not respond to double-clicking the file so how can you open the .mailsignature files? You can copy/paste the following command on the keyboard, all on one line.

open -a TextEdit ~/Library/Mobile\ Documents/com\~apple\~mail/Data/V4/Signatures/*.mailsignature

mojave-terminal-3-44a9b90259597661d2448c9d329432d3.png

This line tells Terminal to open all files in that directory that have a filename that ends with .mailsignature, and to open them using the TextEdit application.

mojave-terminal-4-304b0b1fcdd6f6bf882d5ee011027d9c.png

Once you have the file(s) open in TextEdit, move on to step 12.

11. (You should only do this step if NOT using iCloud Drive.)

Luckily for you, we can use Finder to open the signature file we need. In Finder, select the menu bar item Go > Go to Folder...

mojave-finder-1-11971db0d4cab95c550034eb1c22d87c.png

A panel will popup that allows you to input the direct path to the signature folder. Copy/paste the following line into the box

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

After clicking Go, a finder window should appear with several files.

mojave-finder-3-6cb6f9e99b22dda141998da27251a850.png

Look at the file names and notice the ones that end in .mailsignature. These are the files we are interested in working with. More specifically, we are looking for the placeholder signature file you created earlier. Locate the most recently modified .mailsignature file.

mojave-finder-4-7a49dba26407f06db7199aedf629ad4e.png

If you have more than one signature file in there, or cannot determine which is the placeholder, you can open each of them to help you find the right file. Simply repeat the following process for all the files.

Right-click on the .mailsignature file in Finder, select Open With, and choose TextEdit.

mojave-finder-5-a83ab4ca0cce67086bd13ab691ecbaf8.png

If TextEdit is not an option, choose Other..., and then choose Applications > TextEdit.

mojave-finder-5-a83ab4ca0cce67086bd13ab691ecbaf8.png

Once you have the file(s) open in TextEdit, move on to step 12.

12. Now that you have the .mailsignature file(s) open in TextEdit, we need to ensure it is the right one. Make sure that the placeholder file we created earlier is open by scanning each of the open TextEdit documents for the placeholder text you entered earlier in the Mail.app Preferences panel.

Because the text I entered earlier was Placeholder text, this is what I am looking for now.

mojave-textedit-1-b48157a2e48ff4370dcc7eb8fe05f8ed.png

Look for your placeholder text within the file’s HTML code. Here, we know we have the correct file because we can clearly see our placeholder text: Placeholder text

If you cannot find the placeholder, you may still be in “edit” mode on the signature. Try closing the Mail > Preferences Window, quitting Apple Mail and repeating the previous steps.

If you still cannot find the placeholder, you may need to double check that you are/aren’t using iCloud Drive, as detailed in an earlier step.

13. When you have located the right placeholder .mailsignature file, keep it open and close all other TextEdit windows. Feel free to resize the window to make text editing a bit easier. You will see a few metadata lines on the top of the file and some HTML code below it. Select all that code from the line starting with body, all the way to the end of the file.

mojave-textedit-2-d06cc18771ccc7241a7bed703310c22e.png

14. Keep the top metadata lines, delete the entire block of placeholder HTML code.

mojave-textedit-3-185eb233689b044a861f8a2cda20a323.png

15. Now right-click on the .customhtml file that you copied to your desktop, select Open With, and choose TextEdit.

mojave-finder-5-a83ab4ca0cce67086bd13ab691ecbaf8.png

If TextEdit is not an option, choose Other..., and then choose Applications > TextEdit.

mojave-finder-5-a83ab4ca0cce67086bd13ab691ecbaf8-1.png

Copy and paste all of the html from .customhtml file into the .mailsignature file two paragraphs below the existing meta data.

mojave-textedit-4-9e7aa47eec43a3775d8e60339d6404e6.png

16. Save and close the file, then Quit TextEdit.

17. If you are using iCloud Drive, skip this step and proceed to the next step. You can determine if you are using iCloud for Apple Mail by checking System Preferences > iCloud. Still unsure? Skip this step — you can redo the steps and include this one if your signature is not working correctly at the end.

Even though you saved this file, Apple Mail may use the original version and overwrite your new signature unless you lock the file. With your text editor now closed and the file saved, open Applications > Terminal.app, paste the following line, and press enter to lock all the .mailsignature files in the folder.

Lock Files:
chflags uchg ~/Library/Mail/V6/MailData/Signatures/*.mailsignature

If you mess up, you can unlock the files with this command.

Unlock Files:
chflags nouchg ~/Library/Mail/V6/MailData/Signatures/*.mailsignature

18. Open Apple Mail and go back to Preferences > Signatures. If you have images in your signature, they will not show here in the preview, but they will show in the real signature as long as your coded image source location is valid.

mojave-mail-preferences-8-11380812bf2c4e92adb7fc2204853fa4.png

19. To test that it is working correctly, simply compose a new email using the account you associated this new signature with, and set the signature (right side of screen) to be the one with the name you created earlier. If the images show, and everything looks as it should, you have succeeded!

mojave-mail-compose-1-990d423b6ba86a9f2998b42d810b6b7c.png