Matt Coneybeare


How to Make an HTML Signature in Apple Mail for Yosemite OS X 10.10

| Comments

Looking for Catalina instructions?
Looking for Mojave instructions?
Looking for High Sierra instructions?
Looking for Sierra instructions?
Looking for El Capitan 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 tutorials on how to add HTML Signatures in Lion, Mountain Lion, iOS 7 or Mavericks, but the process has changed slightly for the new OS X Yosemite (10.10). 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,head or body tags, should include only inline css, and should only consist of basic html elements (div, span, img, a, etc…).

    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 3 different places depending on whether you are using iCloud Drive, iCloud without Drive, or no iCloud at all. If you know which one you are, great! If you don’t, start with the top one and work your way down if you can’t find the folder.

    Using iCloud Drive:
    ~/Library/Mobile\ Documents/com~apple~Mail/Data/MailData/Signatures/
    Not using iCloud Drive, but still using iCloud:
    ~/Library/Mobile\ Documents/Mail/Data/MailData/Signatures/
    Not using iCloud:

    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/MailData/Signatures/
    Not using iCloud Drive, but still using iCloud:
    ls -laht ~/Library/Mobile\ Documents/Mail/Data/MailData/Signatures/
    Not using iCloud:
    ls -laht ~/Library/Mail/V2/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 some that start with ubiquitous_ and 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 ubiquitous 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/MailData/Signatures/ubiquitous_*.mailsignature
    Not using iCloud Drive, but still using iCloud:
    open -a TextEdit ~/Library/Mobile\ Documents/Mail/Data/MailData/Signatures/ubiquitous_*.mailsignature
    Not using iCloud:
    open -a TextEdit ~/Library/Mail/V2/MailData/Signatures/*.mailsignature

    This line tells Terminal to open all files in that directory that have a filename that starts with ubiquitous_ and 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 ubiquitout_XXXXXXX.mailsignature file that represents it. This placeholder now should be open in TextEdit.

    If you have more than one ubiquitout_XXXXXXX.mailsignature files open in TextEdit, we have to find the right one. 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.

    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 iCloud Drive, iCloud or no-iCloud folders from the above step.

  7. When you have located the right placeholder .mailsignature file, keep it open and close all other TextEdit windows. You will see a few metadata lines on the top of the file and some html code below it. Select 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 or 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, find it again in Finder and press command-i to bring up the info pane for the file. On this info pane, mark the “Locked” checkbox.

  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. It pays 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.


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