• Home
  • /
  • Blog
  • /
  • A Comprehensive Video Guide to TextExpander

A COmprehensive Video Guide To TextExpander

TextExpander is a text expansion app for Mac created by Smile Software. TextExpander is just one of several text expansion apps available for Mac, but amongst Mac nerds that I respect, TextExpander is widely considered the most popular and the most powerful. Thanh recently wrote about the basic features of TextExpander and how he uses it on a daily basis, and in this post I want to dive in a little deeper by showing you how you can use the different macro types that are available in TextExpander to create your own (and more complex) “snippets”.

In TextExpander terms, a “snippet” is what is displayed when you type the assigned TextExpander abbreviation. For example, an abbreviation like “tyvm” might expand to the the snippet “thank you very much”. I use this a lot for quotes. For example, I have an abbreviation “xplan” that expands to the snippet of one of my favorite quotes, “those who fail to plan, plan to fail”. So at its core, TextExpander is exactly what it sounds like – a program that expands text. And if this was the only way you ever used TextExpander, the app would still be well worth the $35 list price because it would still save you a ton of time.

However, many times the text you end up typing repeatedly has variable or optional content. This is where the macros we’re going to discuss in this post can really come in handy.

Introduction to Macros

There are several different types of macros in TextExpander. Keep in mind that you don’t need to actually memorize these macros as they can all be inserted using the Insert menu in TextExpander:

TextExpander Insert Menu
The insert menu in TextExpander gives you access to the macros.

Here’s a list of the different types of macros that are available in TextExpander:

  • Date/Time
  • Snippets
  • Key
  • Clipboard
  • Picture
  • Cursor
  • Fill-Ins

In the rest of this post, I’m going to break these macros down individually and there’s a video example associated with each.

Date & Time

One of the most practical applications of TextExpander’s macros is for date & time stamping. You can use TextExpander to put in times and dates using different macros for different formatting options. Here’s a table with all the different macro options for displaying date & time information:

Macro Expanded Text
%Y 4 digit year number (“2014”)
%y 2 digit year number (“14”)
%B Fully spelled month name (“August”)
%b Abbreviated month name (“Aug”)
%m 2 digit month number (“08”)
%1m Month number (“8”)
%d 2 digit day number (“08”)
%e Day number (“8”)
%A Fully spelled day name (“Friday”)
%a Abbreviated day name (“Fri”)
%I 2 digit 12-hour clock number (“02” for 2 am or 2 pm)
%H 2 digit 24-hour clock number (“02” for 2 am or “14” for 2 pm)
%1H Trimmed 12-hour clock number (“2” for 2 am or 2 pm)
%1I Trimmed 24-hour clock number (“2” for 2 am, “14” for 2 pm)
%M 2 digit minutes number (“05”)
%1M Trimmed minutes number (“5”)
%S 2 digit seconds number (“03”)
%1S Trimmed seconds number (“3”)
%p Expands to AM or PM


For example, a snippet that would expand to Friday, August 8 2014 – [2:05:03] PM would be written:

%A, %B %e %Y - %1I:%M:%S %p

You don’t need to memorize these macros, however – you can actually select these from inside the insert menu.

TextExpander Insert Menu
The TextExpander Insert menu in all it’s glory.

Here are a couple more examples of standard date/time format snippets that you can add to TextExpander:

Macro Example Text
%m-%Y 08–2014
%m-%d-%Y 08–08–2014
%m/%d/%Y 08/08/2014
%d %b %y 8 Aug 14
%d %b %Y 8 Aug 2014
%B %e, %Y August 8, 2014


Adding date/time stamps like this to your notes and information is extremely helpful. Zachary recently wrote a post on the importance of dating everything. Here are a couple examples of things that could benefit from date/time stamps:

  • journal entries
  • meeting notes
  • any form of electronic communication
  • filenames (especially when going paperless)

You can also do date/time math to add or subtract units of time in Text Expander. To do this, simply put the date/time math prefix BEFORE the unit of time you want to modify (you can do this through the insert menu as well – please see the video example). Date/time math macros begin with “%@” and are followed by a “+” or “-” and then the unit of time you want to add or subtract (i.e. “D” for days). For example, “Make sure you file your expense reports from the conference by %@+14D%B %e, %Y. ” would add 14 days from the current date.

Nested Snippets

Did you know that you can actually put snippets inside of snippets? This is called a Nested Snippet and allows you to use a snippet in more than one place without having to type it out again (or even the abbreviation). To add a snippet inside a snippet, just select it from one of your snippet folders using the “Insert” drop-down in TextExpander and selecting “Snippet”, or by using the macro %snippet:(snippet_abbrev)% where (snippet_abbrev) is the abbreviation of the snippet you want to use.

TextExpander Snippet Selection
TextExpander Snippet Selection.

This is useful when you want to use a quote within a standard email message. For example, previously I told you about a snippet I created for one of my favorite quotes titled “Fail to Plan” that says “those who fail to plan, plan to fail” that is expanded by using the abbreviation “xplan”. I could nest this snippet inside a reminder email for my team members at work to submit their contributions on a particular project, which would look something like this:

Just a reminder that the current sprint is wrapping up this week and we still haven't received all team contributions. Without all the required pieces it is impossible to roadmap this project and I'm concerned about falling behind on our target dates. Remember, %snippet:xplan%.


This macro simulate a key press. There are 4 options to choose from: Enter, Escape, Return, or Tab. This can be useful when filling out forms to switch from one field to another without actually having to touch your keyboard – just let TextExpander do it for you! You can do this by selecting “Key” from the Insert menu in TextExpander or by using the macro %key:(key name)% where (key name) is the name of the key.

TextExpander Key Press Selection
TextExpander Key Press Selection.

For example, you could create a snippet which filled out your phone number and automatically jumped to the next field for filling out web forms by creating a snippet like this:


However, we HIGHLY recommend you do not use this approach for your online passwords. For one thing, TextExpander doesn’t work with secure input fields (“Mr. President, we’re here for your protection!”), but more importantly it exposes your passwords and account credentials to anyone who might gain access to your snippet collection. For example, if you sync your snippets using Dropbox and your Dropbox credentials are compromised, all of your snippets (which are stored in plain text) are accessible. Please, use something like 1Password to store your passwords securely instead (another Asian Efficiency favorite)!


This macro puts the contents of your clipboard into the designated area of the snippet. You might use this when sending an email to multiple recipients (like a party invitation) and you want their name to appear several times throughout the email message. You could copy their name from an invite list and then have it appear wherever %clipboard appears.

You can also plug in this macro from from the Insert menu:

TextExpander Clipboard Selection
TextExpander Clipboard Selection.

Here’s an example:

Hi %clipboard! I'm throwing a birthday party for our friend Thanh next Saturday at Whole Foods (he really loves that place), and I really hope you can come. I know it would mean a lot to him if you were able to make it. Please RSVP to me so we know how many to expect. Hope to see you soon, %clipboard!

Assuming we copied the name “Zachary” to our clipboard before typing the snippet, here’s what it would look like:

Hi Zachary!

I’m throwing a birthday party for our friend Thanh next Saturday at Whole Foods (he really loves that place), and I really hope you can make it. I know it would mean a lot to Thanh if you were able to come. Please to me so we know how many to expect.

Hope to see you soon, Zachary!


Here’s a couple other things that could be used with the %clipboard snippet:

  • names
  • phone Numbers
  • email Addresses


Did you know that TextExpander isn’t just for text? You can actually use it to place images as well. This could be useful for a company logo – for example, typing “aelogo” could expand into the Asian Efficiency logo.

TextExpander Picture Selection
TextExpander Picture Selection.

This could also be useful for storing:

  • logos
  • infographics
  • animated gifs


You can use this macro to move your cursor to a certain location within your snippet (called the “insertion point”). You can add this macro by selecting “Cursor –> Position Cursor Here” from the Insert menu or by typing ⌘| (Command + vertical line character).

TextExpander Cursor Selection
TextExpander Cursor Selection.

This could be useful when sending an email to multiple people about a common topic but you still need to customize each message, like telling people what to bring when planning a party. For example:

Thanks for agreeing to help me throw a surprise party for Thanh. Just a reminder that the party is this Saturday at 4 pm and I'll need you to bring ⌘| for the party. I really appreciate all your help!

This is also very useful for code snippets. For example, I could make a snippet that looks like this:

<div id="⌘|">

By putting the macro for moving the cursor (⌘|) between the quotation marks, the cursor will be automatically moved to that position after the snippet is expanded and I can simply type in the value:

TextExpander Cursor Div Example
The Cursor macro can really speed up coding.

You can also move the cursor up, down, left or right of the insertion point. These are represented by ←, →, ↑, or ↓ (⌘<, ⌘>, ⌘^, or ⌘v). For example, if you wanted to move the cursor down two lines at the end of the snippet, you could accomplish this by typing ⌘v⌘v.


Fill-Ins are very powerful macros that allow you to do some crazy things with TextExpander. There are 4 types of fill-in macros you can choose from:

1. Single-Line Field

This macro has 1 specific field where you can type in the text that you want to appear. For example, you could have a single-line field named “First Name” which would expand with the salutation and a field where you could type in the recipient’s first name. This is a great way to personalize form email templates. You can add a single-line field fill-in by selecting “Fill-Ins –> Single-Line Field” from the Insert menu in TextExpander.

TextExpander Single-Line Fill-In Setup
TextExpander Single-Line Fill-In setup options.

The macro for a single-line field is %filltext% with other options for field name, default value, and width. So if you wanted to use a single-line field fill-in for customizing the top of an email template, it would look something like this:

Hi %filltext:name=First Name%,

This macro would expand to look like this:

TextExpander Single-line FIll-In Example
A very basic TextExpander Single-Line Fill-In.

Here are a couple other examples where single-line field fill-ins might be useful:

  • title
  • author
  • genre

2. Multi-Line Field

This macro is just like the single-line field except you get a text box that you can fill in, kind of like the “Messages” or “Additional Comments” field in many web forms. This is extremely useful for short lists, and the advantage of this over the single-line field is that the multi-line field obviously allows for much more text.

The macro for a multi-line field is %fillarea% with other options for field name, default value, and width, and height. So if you wanted to use this macro inside a snippet for creating paragraph tag text for web development, it would look like this:

<p>%fillarea:name=Paragraph Text%</p>

To set this up, place the cursor between the paragraph tags and select “Fill-Ins > Multi-Line Field” from the Insert menu in TextExpander. Make sure it’s placed between the paragraph tags, put “Paragraph text” for “Area Name” and leave default value, width, and height alone for now.

TextExpander Multi-Line Fill-In Setup
TextExpander Multi-Line Fill-In setup options.

In the video example, I’ve named this snippet “p tag” and given it an abbreviation of “xptag”. Now when I switch to my text editor I can type “xptag” and the snippet fires allowing me to type my paragraph text in a format that is ready for the web.

TextExpander Multi-Line Fill-In Example
An example of a TextExpander Multi-Line Fill-In.

Here are a couple other examples where multi-line field fill-ins might be useful:

  • messages
  • summaries
  • meeting agendas

3. Popup Menu

This macro opens a popup menu with a couple pre-populated options for you to choose from. You could use this when sending out appointment reminders to select the representative the appointment is with or selecting from a limited number of variables, like selecting a product when following up with a customer’s recent purchase.

The macro for a popup menu is %fillpopup% with other options for popup name, popup menu items and default setting. So if I wanted to create a standard snippet to use when following up with an Asian Efficiency customer, I could create a snippet that says:

%fillpopup:name=Product:OmniFocus Premium Posts:default=Productivity Blueprint:Asian Efficiency Primer:Premium Newsletters:Better Sleep%

To set this up, I’ll select “Fill-Ins > Popup Menu” from the Insert menu, name the popup “AE Product”, and then fill out the Asian Efficiency product options as my popup menu items – “AE Primer, Premium Newsletters, Better Sleep, OmniFocus Premium Posts, and Productivity Blueprint”. You can also change which option is selected by default (I’ll select OmniFocus Premium Posts).

PopupMenu Example in TextExpander
Popup Menu Example in TextExpander.

In the video example, I’ve named this snippet “AE Products” and have given it an abbreviation of “xprod”. Now when I switch to my Mail app and I want to send a follow up message to an Asian Efficiency customer, I can type “xprod”, select the appropriate product from the popup menu, hit “OK” and the appropriate text is pasted into the body of my email message.

TextExpander Popup Menu Example
Using a Popup Menu Fill-In is a great way to select between variables in TextExpander.

Here are a couple other examples where popup menus could be useful:

  • date selection (M-F)
  • selecting a team member
  • selecting a product or service

4. Optional Selection

This macro includes a section of text that you can include by selecting a checkbox. You might use if there’s a clause you sometimes include in a contractual agreement or if you sometimes include certain information at the end of a standard email response.

The macro for an optional selection is %fillpart%(optional text)%fillpartend% where (optional text) is the text you want to include in the optional selection. There are other options for Optional Part Name and whether or not to include it by default.

TextExpander Option Selection Example
TextExpander Option Selection Example.

So if I wanted to create a snippet to follow up with someone who commented on a recent Asian Efficiency blog post, I could create a snippet that looks like this:

Thanks for reading the Asian Efficiency blog. %fillpart%Since you seem to like Omnifocus, you might want to check out this update to Omnifocus premium Posts.%fillpartend%

Here’s what it looks like when I type my abbreviation:

TextExpander Optional Selection Example
Optional selections in TextExpander are great for including semi-standard information in emails.

Now not everyone who reads the Asian Efficiency blog is interested in OmniFocus (hard to believe, I know), so we may not want to include that last part all the time but it occurs often enough that we still don’t want to type it manually either. Using an optional selection within our TextExpander snippet allows us to stay Asian Efficient without anoying our non-OmniFocus using customers.

Here are a couple other examples where optional selections could be useful:

  • customer support links
  • references for customers
  • conference call information

Pulling it all together

The best part about TextExpander snippets is that you’re not limited to just one of these macros per snippet. You can actually link them together and combine them to do some pretty crazy things from increasing your email productivity by storing all your email templates in TextExpander to speeding up your development time by reusing code snippets for developers.

Here’s an example of a fairly complex email snippet:

Hi %filltext:name=First Name:default=First Name%,

Thanks for taking the time to speak with me %fillpopup:name=Webinar:yesterday:default=today:a few days ago%.  As we discussed, I’ve prepared a proposal for you.  To view the proposal, use this URL: %clipboard

%fillpart:name=Trial%If you’d like to take advantage of our free trial offer, just go to our website – www.notarealsite.com/trial.

%fillpartend%%fillpart:name=Portfolio%If you’d like to view or download a sample report, you can do so using this link: www.notareallink.com/portfolio

%fillpartend%%fillpart:name=Purchase%If you’d like to pilot the program and purchase a few credits to start, use this URL: www.notarealsite.com/buystuff

%fillpartend%%fillpart:name=Reference%If you’d like to speak to someone who is currently using our products, here are some references you may contact:

Thanh Pham
Asian Efficiency
123 Not a Real Street
Somewhereville, CA 12345
(555)555–5555 x 1

Mike Schmitz
Asian Efficiency
123 Main Street
Somewhere Else, FL
(555)555–5555 x 2

%fillpartend%I will follow up with you %fillpopup:name=Follow Up:in a few days:default=next week:in a couple weeks% to make sure you got everything and see if you have any questions.  If you need anything before then, please feel free to contact me.

Here’s what it looks like when I type the abbreviation:

Email Example with TextExpander
Here’s what it looks like when we tie it all together.

You’ll notice there are several Fill-Ins that I can customize. There’s one for first name, there’s a popup for when the webinar actually happened, there are optional selections for information I include often but not every time, and a pop for when I’m going to make contact next. There’s also a clipboard reference where I pull in the link for the proposal off of my clipboard.

Using this snippet, once I’ve selected and filled out all the information I want to include, I can just hit “OK” and my entire email has been written for me.

BONUS: Applescript

Did you know that you can even run Applescript via TextExpander? For example, you could have Applescript snippet that opens the current URL in Chrome instead of Safari. Chrome has built-in Flash support, so this would be one way to get around installing the Flash plugin on your computer if you wanted to avoid that.

Full disclosure, I do not know Applescript, and this example comes from the Smile Software blog. All credit for this goes to them, and if you like this example please support them and buy TextExpander.

Here’s how to set it up:

  1. Set the label “Open URL in Chrome”.
  2. Set the abbreviation (i.e. “cchrome”).
  3. Create a new snippet with content type “Applescript”.
  4. Paste the Applescript into the TextExpander window. Here’s the Applescript:

property theURL : “”
tell application “Safari”
   set theURL to URL of current tab of window 1
end tell
   if appIsRunning(“Google Chrome”) then
      tell application “Google Chrome”
      make new window
      set URL of active tab of window 0 to theURL
   end tell
   tell application “Google Chrome”
      do shell script “open -a \”Google Chrome\””
      set URL of active tab of window 0 to theURL
   end tell
end if

on appIsRunning(appName)
   tell application “System Events” to (name of processes) contains appName
end appIsRunning

Now just go to the currently open Safari tab or window and type “cchrome”. Chrome will open and the current tab will be displayed.

Tip: This could be really useful for running Applescripts with OmniFocus, which has great Applescript support.

A Few Tips

As you can (hopefully) see from this post, there are a ton of possible uses for TextExpander. It’s an incredibly useful utility that will save you a lot of time, but like any tool it’s only effective if you use it correctly. In addition to the examples we’ve covered in this post, here are a couple general best practices for you to keep in mind as you implement TextExpander into your personal workflow:

Tip #1: Sync Your Snippets

You can sync your snippets via Dropbox which allows you to access them via TextExpander touch and other supported apps on your iOS device. To do this, you have to go into “Settings”, click on “Sync” and select “Dropbox”.

TextExpander Sync Options
TextExpander sync options.

There are quite a few apps that support the TextExpander touch API. Here’s a full list in case you’re wondering whether your favorite app is supported.

Tip #2: Use a Standard Prefix

Thanh talked in this article about the different prefixes he uses for different types of snippets (which is a very logical way to organize your TextExpander snippet collection), but I tend to use a prefix of “x” for everything. There are a couple reasons for this:

  1. I can’t imagine a scenario where I would type an actual word starting with x that would conflict with my snippets
  2. I know when I type “x_” that it is definitely a TextExpander snippet
  3. The “x” character is easily accessible on the iOS keyboard (for expanding snippets via TextExpander touch)

Note: There really isn’t a “right way” to organize your snippets in TextExpander. The important thing is consistency. You just need to find something that makes sense to you and is easy to remember.

Tip #3: Think Like a Productivity Ninja

Before adding any tool to your workflow, you should ask your self the questions “what problem will this tool help me solve?” Everything needs to have a role and a purpose. In the case of TextExpander, the problem it’s solving is the amount of time spent repeatedly typing words and phrases you commonly use. But if you don’t pay attention and catch yourself repeating things all the time, you can get stuck just blindly going through the motions and continuing to do the same thing over and over.

Instead, you should be self-aware: every time you find yourself doing something more than once, ask yourself “how can I automate this?” With TextExpander, it’s easy – just put in the text you find yourself typing often and it will take care of the rest. But without your own homegrown snippet library, the power of TextExpander won’t do you very much good.

Here are a couple other ideas for how you can use TextExpander to get you started:

  • media review templates
  • form emails
  • OmniFocus tasks
  • meeing agendas
  • auto-correcting common mistypings
  • code snippets
  • adding Markdown syntax


Hopefully this guide to TextExpander has pointed you in the right direction on how to use this incredibly powerful Mac utility, but it’s really only scratching the surface. We’d love to hear how you’re using TextExpander in the comments!

If you’re interested in checking out TextExpander, there’s a free trial available on their website. If you’re part of The Dojo, our exclusive members-only community, you get a special discount.

Next Actions

Do you want to see more examples of our personal systems and workflows? We reveal them all on our Lifehacks seminar. It’s completely free and you’ll get to see the exact step-by-step systems and workflows that we personally use to be insanely productive. Register for the next available seminar here.

You may also Like

Last Updated: March 14, 2023

Read More
Read More
Read More


Thanh Pham

Founder of Asian Efficiency where we help people become more productive at work and in life. I've been featured on Forbes, Fast Company, and The Globe & Mail as a productivity thought leader. At AE I'm responsible for leading teams and executing our vision to assist people all over the world live their best life possible.

Leave a Reply

Your email address will not be published. Required fields are marked

  1. Very well done videos and info!! It got my feet wet on the more advanced features of TextExpander I haven’t delved into yet!. Great job!

  2. I use TextExpander to name video files by date:

    Abbreviation= !dt
    Content= %Y%m%d_

    Result: 20140807_

    …complete with company name and the person who was recorded on video. Final example:


    So whenever I have the files in the Finder organized by date of recording.


  3. I’ve tried the picture snippet method in several apps and I get the cute little expansion sound, but nothing shows up for the picture. MS Word of course is one of those that does not seem to play nice.

  4. This is great!

    I’ve had TextExpander for a while but I didn’t know all of the cool date/time stuff it could do.

    Thanks for the demo. :)

  5. Great article to just get started. Thank you once again.

    Nested snippets in TE Touch:
    Being on holiday right now I did my first steps on my iPad and with TextExpander Touch. To get a nested snippet to run as expected, I had to “close” the code with an extra “%” at the end, i.e. %snippet:xdate%. Without the last “%” the code was not properly executed.

{"email":"Email address invalid","url":"Website address invalid","required":"Required field missing"}