How To Create Smart Phrases In Epic: The Ultimate Clinical Documentation Guide
Smart Phrases (commonly known as `.$.) in Epic EHR streamline repetitive clinical documentation by inserting pre-built text blocks, smart data, and dynamic variables directly into patient charts. Mastering this functionality reduces click fatigue, ensures regulatory compliance, and saves clinicians an average of 45 minutes per shift.
Prerequisites and Clinical Workflow Planning
Successful clinical documentation design begins long before entering the Hyperspace environment. Building efficient automation requires a thorough understanding of Epic's Smart Text and Smart Phrase architecture, user-role security permissions, and institutional template standards.
- Essential tools and permissions: Hyperspace access, Clinical Builder or Template Creator security class, active patient context or test chart environment.
- Mandatory prerequisite knowledge: Understanding of dot-phrase syntax, SmartData Elements (SDEs), and context-specific variables like patient age, gender, and current encounter diagnosis.
- Estimated build duration: 15 to 30 minutes per complex phrase, including validation testing.
Step-by-Step Implementation of Epic Smart Phrases
Step 1: Accessing the Text Builder Utility
Navigate to the Epic Utility menu and search for Text Builder, or access the tool directly through your user settings toolbar depending on your organization's Hyperspace configuration. Ensure you are operating within the correct facility context to avoid creating restricted or overly localized phrases that fail to propagate across different health system clinics.
Pro-Tip: Pin the Text Builder activity to your Epic Hyperspace shortcut toolbar for instant access during routine template maintenance rounds.
Step 2: Defining Phrase Properties and Abbreviations
Click the New button to initialize a blank phrase record. Enter your desired abbreviation in the Name field, keeping in mind that Epic automatically prepends a period (.) to your designated string, so typing normal exam turns into dot normal exam. Assign a descriptive display name that indicates the clinical specialty and primary use case, such as cardiology acute chest pain or pediatric well check.
Step 3: Authoring Clinical Text and Incorporating SmartData
Compose your standard narrative prose within the main text editor window, maintaining institutional style guides and billing compliance standards. Integrate variable data fields by inserting SmartLinks, which pull live data from the chart such as most recent lab values, vital signs, or medication lists using specific syntax like asterisk lab value asterisk.
Warning: Avoid hardcoding static patient values or outdated clinical guidelines into your Smart Phrases, as unchecked macros can lead to note bloat and severe compliance risks during billing audits.
Step 4: Configuring Security Access and Sharing Levels
Determine the appropriate sharing level for your newly created phrase before saving your work. Select user level if the phrase contains personal preferences, department level for clinic-specific workflows, or global enterprise level for standardized health system documentation pathways. Verify that your categorization matches your organization's governance rules to prevent cluttering the shared organizational directory.
Step 5: Testing and Validating in a Sandbox Environment
Open a test patient chart or a dedicated training environment encounter to validate the functionality of your newly minted dot phrase. Type the shortcut into an open progress note or SmartForm field, verify that all SmartLinks evaluate correctly, and confirm that conditional logic structures execute without displaying raw backend syntax errors.
Structured opioid refill clinic epic smartphrases | PDF
Smart Phrase Architecture and Component Comparison
| Component Type | Primary Function | Evaluation Behavior | Typical Clinical Use Case |
|---|---|---|---|
| Smart Phrase (.phrase) | Inserts static or dynamic text blocks | Evaluated once upon insertion | Complete physical exam templates, discharge instructions |
| SmartLink (link) | Pulls real-time patient data from chart | Evaluated dynamically at runtime | Lab results, vital sign summaries, current medication lists |
| SmartList (,list) | Provides selectable drop-down menus | User-interactive selection | Review of systems normals, symptom duration selectors |
| SmartText (.text) | Governs entire note layout and sections | Structures complete documentation | Initial consultation notes, annual wellness visit forms |
Common Documentation Failures and Field Fixes
Symptom: SmartLinks resolve as blank spaces or error codes inside the finalized progress note.
- Root Cause: The selected SmartLink requires a specific clinical context or encounter type that is missing from the current patient chart.
- Actionable Fix: Replace the generic SmartLink with an encounter-specific alternative, or verify that all necessary flowsheets and vitals have been documented prior to phrase insertion.
Symptom: The dot phrase fails to appear when typed into the note editor.
- Root Cause: The abbreviation conflicts with an existing enterprise system phrase, or the user lacks the proper security class permissions to access the record.
- Actionable Fix: Check the Epic Phrase Manager directory for naming collisions, and append your specialty or initials to the shortcut name to ensure global uniqueness.
Symptom: SmartLists within the phrase freeze or do not register user selections correctly.
- Root Cause: Corrupted macro syntax or nested SmartLists exceeding Epic's allowable parsing depth limit.
- Actionable Fix: Open the SmartList definition utility, flatten nested selections into sequential single-level lists, and re-test the phrase within a sandbox encounter.
Frequently Asked Questions
What is the difference between a Smart Phrase and a SmartText in Epic?
Smart Phrases are shorthand dot-shortcuts that insert blocks of text, lists, or links into any note field. SmartTexts govern the overall structural framework of an entire clinical document, organizing sections like history of present illness, objective findings, and medical decision making.
Can I share my custom Smart Phrases with colleagues across different departments?
Yes, by configuring your phrase sharing settings to Department or Enterprise level during the build process. However, enterprise-wide sharing typically requires approval from your organization's clinical informatics governance committee to maintain documentation standards.
How do I update an existing Smart Phrase without changing its shortcut?
Navigate to Text Builder, search for your existing phrase abbreviation using the lookup window, make your required edits to the text body or SmartLinks, and click Accept. The system updates the underlying record immediately, and all subsequent uses of the shortcut will reflect the revised content.
Are there limits to how many Smart Phrases I can create?
Epic does not enforce a strict hard technical limit on the number of personal phrases an individual user can build. However, maintaining an unorganized library of hundreds of redundant phrases can severely degrade search efficiency and slow down your documentation workflow.
Optimize Your Clinical Documentation Workflow Today
Take control of your daily documentation burden by auditing your most frequent charting patterns and building customized automation rules tailored to your exact clinical specialty. Begin designing your optimized Epic environment now to reclaim valuable time for direct patient care and improve overall chart accuracy.
