Matt Coneybeare


How to Make an HTML Signature in Apple Mail for High Sierra OS X 10.13

| Comments

Looking for Catalina instructions?
Looking for Mojave instructions?

There are plenty of tutorials online to create an HTML signature in Apple Mail with older versions of OS X, and you have probably already seen one of my other tutorials on how to add HTML Signatures in Lion, Mountain Lion, iOS 7, Mavericks, Yosemite, El Capitan, or Sierra, but the process has changed ever so slightly for the new OS X High Sierra (10.13). Here is how to do it:

  1. In Apple Mail, go to Preferences > Signatures and create a signature with any random content. Name it something meaningful in the central column. You will be swapping this out later.

  2. Associate the placeholder signature with one of your email accounts by dragging its name from the second column in the Preferences > Signatures window to an email account in the first column.

  3. Close the Preferences window to save it, then quit Apple Mail.
  4. Write an html page inside of your favorite text editor. I use TextMate 2. Please do NOT use Microsoft Word, Dreamweaver or any other “smart” editor as these editors will manipulate your final code in a way which will most likely break your design for certain recipients.

    The page should not have html or head tags, should include only inline css, and should only consist of basic html elements (div, span, img, a, etc…). Even though many email programs now support more advanced tags, there is a still a large percentage of people who use older versions of Outlook and other software, and you want your signature to look great for them too.

    Here is some example code to get you started.

  5. We are going to need to locate the folder containing the placeholder signature. Unfortunately, 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 editable by hand. Trying to navigate through by clicking in Finder will usually lead you to your visible iCloud Drive folder with nowhere to go. Don’t worry though, I will walk you through an alternative method of getting at those files.

    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 by going to System Preferences > iCloud, then seeing if the iCloud Drive checkbox is ticked or not.

    Using iCloud Drive:
    ~/Library/Mobile\ Documents/com~apple~mail/Data/V4/Signatures/
    Not Using iCloud Drive:

    Open, found in Applications > Utilities, paste the following line into the box and press enter

    Using iCloud Drive:
    ls -laht ~/Library/Mobile\ Documents/com~apple~mail/Data/V4/Signatures/
    Not Using iCloud Drive:
    ls -laht ~/Library/Mail/V5/MailData/Signatures/

    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, try the next path on the list above.

    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 step 1. If you have more than one mailsignature file in there, then you need to find the one you created in step 1. 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 ther contents. 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.

    Using iCloud Drive:
    open -a TextEdit ~/Library/Mobile\ Documents/com\~apple\~mail/Data/V4/Signatures/*.mailsignature
    Not Using iCloud Drive:
    open -a TextEdit ~/Library/Mail/V5/MailData/Signatures/*.mailsignature

    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.

    Once you have these files open in TextEdit, move on to next step.

  6. When you created a temporary placeholder signature in step 1, Mail automatically created a XXXXXXX.mailsignature file that represents it. This placeholder now should be open in TextEdit.

    If you have more than one XXXXXXX.mailsignature files open in TextEdit, we have to find the right one amongst them now. To help ensure you have the right file, look the one you think is your placeholder in TextEdit. You should see the placeholder text you entered in step 1, along with other code and metadata.

    Look for your placeholder text in the highlighted part shown in the image above. Here, we know we have the correct file because we can clearly see our placeholder text: “This is a placeholder.”

    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 opening the files using the process outlined in the previous step.

    If you still cannot find the placeholder, you may need to try one of the other folders from the above step.

  7. 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 only the placeholder code.

  8. Keep the top metadata lines, but replace the html in the file with your own from step 2.

  9. Save and close the file.
  10. 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 save 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, go back to terminal, enter the following line, and lock all the mailsignature files in the folder.

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

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

    Unlock Files:
    chflags nouchg ~/Library/Mail/V5/MailData/Signatures/*.mailsignature
  11. Open Apple Mail and go back to Preferences > Signatures. If you have images in your signature, they will will not show here in the preview, but they will show in the real signature if the image source location is valid.

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

If you need additional help with html signature design or implementation, I have founded a company called GiantUser (it’s an anagram of “signature”) to do just that with very reasonable prices. Check it out!

Finally, I also run a small software company called Urban Apps and a New York City cultural blog called Viewing NYC. They pay the bills so I can take the time to write helpful posts like this one.

If you found this posting helpful at all, I would really appreciate it if you would check out my iPhone/iPad Apps on the iTunes App Store, check out Viewing NYC, or even buy me a beer!


My name is Matt Coneybeare, I design and develop for the web, iOS (iPhone, iPad and iPod Touch), and MacOS out of New York City. In 2008 I started a software company called Urban Apps that has made some pretty popular apps such as Ambiance and Hourly News. In 2019, I joined the team at Ticket Evolution as a Senior Software Engineer. My current Stack Overflow reputation is about 27k.

I was a Rockstar a decade ago, but then went back to school and collected a Bachelor's Degree in Computer Science from U.C. Berkeley and a MBA from Quantic. Now I am settled down with my beautiful wife Di and our dog Hamachi. When not at my desk, I love exploring New York City as a Yelp Elite, or training for marathons.

Contact information

Matt Coneybeare