Adding an HTML signature in Apple Mail

In this article we’ll guide you through the process of adding an HTML signature to Apple’s Mail client.

  1. In Apple Mail, open Preferences > Signatures.
  2. Select you email account in the left column.
  3. Now create a new signature by clicking on + icon.
  4. 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.
  5. Ensure the Always match my default font checkbox is off
  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.
  7. Close the Preferences window to save it, then Quit Apple Mail.
  8. Now we are going to open the HTML signature file.
  9. We are going to be using TextEdit to open the code file 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. Close the Preferences panel, and close the new document.
  10. 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 > Apple ID……then look to see if the iCloud Drive checkbox is ticked or not.Double-check that iCloud Drive is enabled for Mail by clicking the Options button and ensuring the checkbox next to Mail is ticked.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 12.
  11. (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. 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.
    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 one .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. 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 the file(s) open in TextEdit, move on to step 13.
  12. (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...

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

    After clicking Go, a finder window should appear with several files. 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. 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. If TextEdit is not an option, choose Other..., and then choose Applications > TextEdit. Once you have the file(s) open in TextEdit, move on to step 13.
  13. 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.

    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 textIf 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.
  14. 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.
  15. Keep the top metadata lines, delete the entire block of placeholder HTML code.
  16. Still keeping the top metadata lines, paste in your own custom HTML code from earlier.
  17. Save and close the file, then Quit TextEdit.
  18. 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.


    To prevent Apple Mail from using the original version and overwrite your new signature unless you lock the file. You can do this by right-clicking on the file and clicking on Get Info option. In the following info dialog you can choose to lock the file. If you want to edit your signature afterwards you’ll need to unlock the file the same way.
  19. 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.
  20. 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!

GUTJAHR