guides

How to Use Dot Phrases Outside Epic and Other EHRs

By Lightning Assist TeamNovember 14, 20268 min read
dot-phrasesepicsmartphraseshealthcaretext-expanderwindowsmac

Short answer: Epic SmartPhrases, the dot phrases you insert by typing a period and a short name, are stored and expanded by Epic. They work in your notes and discharge instructions, but not in Outlook, Teams, a Word letter or a payer's website. To use the same shortcuts there, rebuild the ones you need outside the chart in a desktop text expander. Two rules keep that safe: leave patient information out of the shortcuts, and give them a different symbol than the dot so they don't compete with Epic's own.

Disclosure: we make Lightning Assist, a desktop text expander. What this article says about Epic comes from the American College of Emergency Physicians' Epic guide, linked under Sources. We have not tested Lightning Assist inside Epic.

What dot phrases do inside Epic

According to the ACEP guide, Epic gives clinicians several "smart" tools:

  • SmartPhrases: you type a period followed by a short name you made up, such as .hpibackpain, and Epic inserts the saved text into the note or the discharge instructions.
  • Wildcards (***): blanks inside a SmartPhrase that you fill in or double-check. F2 jumps to the next one.
  • SmartLists: a list of choices, so you pick a value instead of typing it.
  • @ fields in SmartText: they pull data that is already in the chart, such as the patient's name, age, vital signs and results.
  • Sharing: you create SmartPhrases in SmartPhrase Manager or by highlighting text in a note. You can share them with colleagues, and with your IT department's help they can become department-wide or hospital-wide.

All of that lives inside Epic. None of it follows you into an email, a Word letter, a Teams chat or a referral portal in your browser.

What carries over to a text expander, and what doesn't

In Epic In Lightning Assist What changes
A SmartPhrase you call with .name A snippet with an Abbreviation and a Prefix, such as ;refill Same idea. Use another symbol than the dot (see below).
*** wildcards and F2 Fill-in fields such as [#Medication#] The Replacements Window asks for every value before the text is inserted, instead of you jumping between blanks afterwards.
SmartLists Add Choice A drop-down in the same window. Up to 5 options per list on the free plan, 30 on Pro or during the trial.
@ fields that read the chart Nothing A text expander can't read the chart. Use a fill-in field for that part and type it yourself.
Department-wide SmartPhrases A shared library in Teams Team members use the team's snippets on Pro or during their 14-day trial.
Today's date Today's Date on any plan; Tomorrow, In 7 days and In 30 days on Pro or during the trial Filled in at the moment you expand.

Step by step: rebuild the phrases you use outside the chart

The example below uses made-up text and contains no patient information.

  1. Pick the phrases you retype outside Epic. Typical ones: refill replies, portal answers, the opening of a referral letter, prior authorization cover notes, out-of-office replies. Anything that needs data from the chart stays in Epic.

  2. Install Lightning Assist on Windows 10 or 11, macOS 12 or newer, or Linux. The Windows installer needs no administrator rights, but your organization's rules about which apps you may install still apply. The app needs a free account, which you create in the app with email or Google.

  3. Create the snippet. In My Snippets, click Create Snippet and fill in:

    • Name: Refill approved
    • Abbreviation: refill
    • Prefix (optional): ;
    • The text:
    Your refill request for [#Medication#] has been approved and sent to [#Pharmacy#]. Please allow 24 hours before picking it up. If you have questions, reply to this message.
    

    Then click Save Snippet.

  4. Use it. In Outlook, Teams or the portal page, type ;refill. The Replacements Window opens and asks for the medication and the pharmacy, and the finished text is pasted where your cursor was.

  5. Add a pick list where you used a SmartList. For a follow-up interval, for example, use Add Choice with the options "in 1 week", "in 2 weeks" and "in 1 month". In the Replacements Window it becomes a drop-down.

  6. Forgot an abbreviation? Quick Access (Alt+C by default, Option+C on a Mac) lets you search your snippets and insert one with a click.

Moving many phrases at once: if you keep them in a document or a spreadsheet, save them as a CSV with one column for the abbreviation and one for the text, and import it. Replace every *** with a fill-in field like [#Dose#] first, or it stays in the text as three asterisks. The preview and the import are free on every plan: 5 snippets per import on the free plan (up to its 20 snippets), 20 per import during the 14-day trial, and the whole file at once on Pro.

Why not keep the dot?

Lightning Assist accepts any symbol as the prefix, so .refill would work too. But Lightning Assist reacts to what you type on your computer. If Epic runs on that same computer, a dot phrase that exists in both places would have two tools reacting to the same keystrokes. A semicolon, as in ;refill, can't be mistaken for an Epic dot phrase, and you keep the names you already remember.

Can it expand inside Epic itself?

That depends on how your organization opens Epic, as our compatibility page explains:

  • Epic runs as a program or a website on your own computer: to Lightning Assist it is an app like any other, so an abbreviation expands wherever you can paste into a note.
  • Epic opens through Citrix or Remote Desktop: we haven't tested that setup, so we don't claim it works. The remote session receives an expansion only when the connection shares the clipboard, and administrators can turn that off.

Our advice: inside Epic, keep using Epic's own SmartPhrases. They can read the chart, and your organization manages them. Use Lightning Assist for everything outside the chart.

Keeping patient information out

  • Snippets are templates. Keep identifiable patient information out of them and let fill-in fields take the specifics at the moment you send.
  • Where snippets live: they are stored with your account, with their content encrypted, so the same library is on every computer you sign in to.
  • What leaves your computer: expansion happens on your device, and what you type into other apps isn't sent to us. In Hotkey mode, only the short abbreviation goes to our server, to look up the snippet.
  • Two features do send data when you use them: voice dictation sends your recording through our servers to OpenAI for transcription, and AI Commands send the text you select. Keep identifiable patient information out of both.
  • Ask first. Lightning Assist is a general-purpose text expander, not a clinical system. Check with your compliance or IT team before you use any new tool on a work computer or for patient communication.

Where Lightning Assist fits, and where it doesn't

It fits when:

  • you retype the same replies in email, Teams, Word, browser portals and other desktop apps on Windows, macOS or Linux;
  • you want the same library on your work and home computers;
  • the parts that change can be typed into a fill-in field or picked from a list.

It doesn't fit when:

  • the text needs data from the chart: Lightning Assist can't read patient records;
  • Epic opens through Citrix or Remote Desktop and you want expansion inside it: not tested;
  • your computer doesn't allow you to install apps;
  • you need it on a phone: Lightning Assist is a desktop app for Windows, macOS and Linux.

What it costs: text expansion is free and unlimited, with up to 20 snippets on the free plan, and nothing you create is ever disabled or deleted. Pro is $5.99 a month and removes the snippet limit, and you can try it free for 14 days, no card needed.

Download Lightning Assist and rebuild your first phrase in a few minutes. For ready-made examples of findings, instructions and assessment-and-plan phrases, see our medical dot phrases. For everything else clinicians use it for, see the medical text expander page, and what the free plan includes.

Frequently Asked Questions

How do I use dot phrases outside of Epic, like in email and patient portals?

Epic's SmartPhrases only expand inside Epic. Rebuild the phrases you need outside the chart in a desktop text expander such as Lightning Assist: each one gets an abbreviation, a fill-in field for every ***, and a pick list for every SmartList. Then type the abbreviation in Outlook, Teams or the portal page. Keep patient information out of the saved text.

Which tools replace dot phrases with smarter text automation?

Outside the chart, a desktop text expander does the job of dot phrases in your other apps: email, chat, documents and browser forms. Lightning Assist adds fill-in fields, pick lists, date fields and a searchable library (Quick Access), and the same snippets work on Windows, macOS and Linux. Inside Epic, its own SmartPhrases remain the tool that can read the chart.

How do text expansion tools compare to traditional dot phrase systems?

Dot phrases are built into the EHR: they can pull chart data and your organization can share them department-wide. A text expander works in the other apps on your computer, follows you between computers with your account, and asks for the variable parts before inserting the text. It cannot read the chart.

Are there cloud-based tools for managing medical dot phrases?

Lightning Assist stores your snippets with your account, with their content encrypted, and syncs them to every computer you sign in to. Keep identifiable patient information out of them, and check your organization's rules before you use any cloud-synced tool for clinical communication.

What software supports real-time dot phrase expansion in EHRs?

Inside Epic, its own SmartPhrases. A desktop text expander can also expand in an EHR that runs as a program or a website on your own computer. Through Citrix or Remote Desktop it depends on whether the session shares the clipboard; we haven't tested Lightning Assist in that setup.

Can I keep the dot in front of my shortcuts?

Yes, Lightning Assist accepts any symbol as the prefix. If Epic runs on the same computer, use a different symbol, such as ;, so the two tools don't react to the same keystrokes.

Sources