TextExpander
 

Help: Guided Tour: Preferences

Expansion ' Options ' Suggestions ' Hotkeys ' Appearance ' Account ' Update

Preferences menubar

expansion preferences icon Expansion

Expand abbreviations

TextExpander expansions can be triggered three ways:

  • immediately when typed
    When you type an abbreviation, the expansion occurs immediately (depending on Group Settings for "Expand after:")
  • at delimiter (keep delimiter)
    You must type a "delimiter" key, such as space or tab, to trigger the expansion; the delimiter remains after the expansion. For example, if you used a Space to trigger the expansion, you get the expanded snippet followed by a Space.
  • at delimiter (abandon delimiter)
    As with the previous option, a delimiter must be typed to trigger the expansion, but the delimiter does not remain in place after the expansion. For example, if you used a Space to trigger the expansion, you get the expanded snippet, and no Space after it.

If you choose to use one of the delimiter options, click the button Set Delimiter… to select the desired delimiter key. There are over 30 delimiters to choose from, including most punctuation keys, as well as space, return, tab and esc.

When expanding

You can specify what happens when a snippet expands in TextExpander by checking the boxes in this section.

  • Play sound
    You can choose the default sound that TextExpander makes when an expansion is triggered. To specify a sound for individual snippet groups, see Grouping Snippets and Importing Groups.
  • Use cross-platform compatible images (PNGs) (Mac only)
    If you use images in your snippets, TextExpander always pastes the image in PNG format when the snippet is expanded. Some programs, like Microsoft Entourage, work much better with PNGs. Other programs, like Microsoft Word and Excel, may have problems with PNGs. Uncheck this option if you want your images to be pasted in their original file format, such as JPG or GIF.
  • Run script snippets (AppleScript, shell script, JavaScript) (Mac only)
    This allows TextExpander to run AppleScripts, shell scripts, and JavaScripts when expanding snippets. If you share snippets with others and don’t use script snippets yourself, you might choose to turn this off as a safety measure so that you don’t inadvertently run someone else’s script snippets.

  • Restore clipboard
    In cases where TextExpander must use the clipboard, (e.g. in Carbon applications), TextExpander restores the Clipboard to the contents it had prior to the expansion. Depending on your typing speed you may wish to decrease or increase the time delay between when a snippet expands and the Clipboard is restored.

Default Snippet Format

Set the default format of newly created snippets to one of these formats:

  • Plain Text
    When expanded, the snippet content conforms to the current text style.
  • Formatted Text, Pictures
    Color, size, font and alignment can be specified for text. Images and hyper links can be used.
  • JavaScript, AppleScript, and Shell Script Snippets
    These three formats are available only on a per snippet basis (See "JavaScript, AppleScript, and Shell Script Snippets.")

The default snippet format is applied to newly-created snippets. Changing the default does not affect the snippets you have already created.

You can change the format on a per snippet basis in the main window. (See "Creating Snippets: Format.")

Default Case Sensitivity

Choose whether a snippet will expand, and in what letter case, depending on the case you type the abbreviation with. You can set the default case sensitivity to one of these options:

  • Case Sensitive (aB, Ab, ab, AB differ)
    Example: "YT" expands to "Yours Truly", "yt" does not.
  • Ignore Case (aB, Ab, ab, AB same)
    Example: either "YT" or "yt" expands to "Yours Truly"
  • Adapt Snippet to Case of Abbreviation
    Example: "Yt" expands to "Yours truly", "yt" expands to "yours truly"

The default case sensitivity is applied to newly-created snippets. Changing the default does not affect the snippets you have already created.

You can change the case sensitivity on a per snippet basis in the main window. (See "Creating Snippets: Setting Case Sensitivity")

Default is to expand snippet groups in (Mac only)

Select which applications TextExpander will expand in.

  • all applications
    By default, TextExpander is enabled for all applications.
  • all applications except...
    Excludes specified applications from working with TextExpander.
  • only these applications...
    Specifies which applications work with TextExpander exclusively.

You can change this default on a per group basis in the main window. (See "Snippet Groups: Group Settings")

options preferences iconOptions (Mac only)

Capitalize new sentences

The first letter after a period and a space is capitalized automatically.

Double capitals

If two capital letters are typed at the beginning of a word and a third lower case letter is typed, the second letter will be converted to lower case automatically (unless Caps Lock is on).

  • Eliminate at sentence start
    Corrects double capitals at the start of a new sentence (after a period and a space.)
  • Eliminate at word start
    Corrects double capitals at the start of a new word.
  • Do not correct
    Turns off this feature, all double capitals are left as is.

Correct capitalization in

You can customize which applications capitalization correction works within.

  • all applications
    By default, capitalization correction is enabled for all applications.
  • all applications except...
    Excludes specified applications from capitalization correction.
  • only these applications...
    Includes only the selected applications for corrected capitalization.

suggest snippet icon Suggestions (Mac only)

TextExpander can suggest new snippets based on what you type. (See Creating Snippets). TextExpander can also notify you when you forget to use an existing snippet.

  • Suggest snippets based on my typing habits: Turn on or off the suggest snippets feature.
  • Suggest when typing in: Limit the applications where TextExpander will observe your typing for suggesting snippets.
    • All Applications
      By default, TextExpander suggests snippets when typing in all applications.
    • All Applications Except…
      Excludes the specified applications from TextExpander suggestions.
    • Only These Applications…
      Includes only the specified applications for TextExpander suggestions.
  • Snippet Reminders: Notifies you of the snippet abbreviation when you type out the content of a snippet which already exists. (See Snippet Reminders).

hotkeys preferences icon Hotkeys

To set a hotkey, click the Push to set Hotkey button, then press the desired hotkey combination (for example, Control + 1, Option + S). Hotkey combinations must include Command, Control, Option, and/or Shift on a Mac and Control, Alt, and/or Shift on Windows.

  • Open TextExpander
    Displays the main TextExpander window. Especially useful on Mac if you have the Dock icon hidden and do not have the menubar icon displayed.

  • Enable/Disable Expansion
    Useful when you want to temporarily disable TextExpander so that you can type without any expansions being triggered.

  • Create New Snippet
    Opens the Create Snippet window. Enter the snippet content and abbreviation, choose a snippet group to assign it to, and click Create.

  • Create Snippet from Selection (Mac only)
    Opens the Create Snippet window with the currently selected text as the snippet content. Create an abbreviation, choose a snippet group to assign it to, and click Create.

  • Create Snippet from Clipboard
    Opens the Create Snippet window with the current content of the Clipboard as the snippet content. Create an abbreviation, choose a snippet group to assign it to, and click Create.

  • Edit Last Expanded Snippet
    Opens the snippet you expanded last so that you can edit it. After you make the desired changes, click Save.

  • Inline Search
    Press this hotkey combination for TextExpander to show an inline search window hovering near where you type. Type a couple letters of any part of a snippet to search. This is useful if you have a large snippet library or have trouble remembering all your abbreviations. (See Expanding Snippets: Inline Search.)
  • Search Snippets (Mac only)
    Opens the Search Snippets window near the menu bar.

appearance preferences icon Appearance (Mac only)

Show TextExpander in menu bar

Here you can specify the width of the list of snippets that appears when you click on the TextExpander icon in the menu bar.

You can also choose the style of the TextExpander icon itself.

Hide TextExpander icon in Dock

Check this option if you don't want TextExpander to appear in the Dock or in the task switcher.

    Note: If you opt to hide the TextExpander icon in the Dock, that will also hide the TextExpander main menu from view. You can still access TextExpander by choosing Open TextExpander from the TextExpander menubar icon, using the Open TextExpander hotkey, or double-clicking the TextExpander application icon in the Finder.

Launch at Login

Check this option if you want TextExpander to start up automatically when you login to your computer.

Show main window at launch

By default, TextExpander opens its main window when the application launches. If you wish the main TextExpander window to remain closed upon startup, uncheck this option.

Display font for plain text snippets

Select the font for the appearance of your plain text snippets in the TextExpander window. When the snippet expands, it will take on the formatting of the text around it, regardless of how it is displayed in TextExpander.

Default font for formatted text snippets

Set the font your formatted text snippets start with. This is the font style the snippet will expand with.

account icon Account

This tab shows your current account status, activity on snippet and group updates, downloads and uploads between the app and the web server for TextExpander.com. This can be helpful if you want to see if a shared group has had any recent edits, and it can help diagnose any syncing trouble.

For questions about the security of your information on the server, you can find the specifics in our Privacy Policy and an overview in our FAQ.

update preferences icon Update

TextExpander uses an automatic updating service to alert you when new releases of TextExpander are available. By default, TextExpander will check daily for updates, but you can modify that to hourly, weekly or monthly.

The update service also collects anonymous system profile information, which helps us better plan the ongoing development of TextExpander. If you do not wish to share this information, uncheck the box.

You may also view the version of TextExpander you are running.

 

Smile logo

© 2006-2019 SmileOnMyMac, LLC, dba Smile. All rights reserved.
TextExpander is a registered trademark, Smile and the Smile logo are trademarks of SmileOnMyMac, LLC, dba Smile.