Clear, positive instructions are the biggest factor in getting notes you're happy with. This article covers how to write section instructions, the template-wide settings, and how to test changes before you save.
Applies to: All plans · Web app and Best Practice
Write instructions Lyrebird will follow
Each section has an instructions box. Write it the way you'd brief a scribe sitting in on the consult.
Say what you want, not what you don't want. "End the letter after the final paragraph of clinical content" works better than "Do not include a sign-off".
Be specific. Name what belongs in the section, and how much detail.
Keep it short. Long or conflicting instructions are harder to follow. Check your section instructions don't contradict your global preferences.
Give an example of the wording or layout you want.
Instead of | Try |
Don't include social history. | Cover only the presenting problem, examination and plan. |
Don't make this too long. | Write 1–2 sentences summarising the plan. |
Never use the patient's full name. | Refer to the patient by their first name. |
Notes ignoring your template? Rewording instructions this way often fixes it.
Set global preferences
The Global preferences tab applies to the whole note.
Setting | What it does |
Global personalisation | A free-text instruction for the whole note, such as tone or how to refer to the patient |
Global sentence structure | Paragraph, Dot-points, Dashes or Inline-list. A toggle lets you use different structures per section |
Brevity | Language style, not length: Layman (plain language) or Medical (clinical terminology) |
Quote the consult | Yes includes direct quotes from the consultation; No doesn't |
Fill in template settings
On the Settings tab, set:
Consult type: Initial, Review or Both.
Description: a short summary of what the template is for.
Field of practice.
These match the filters on the template tabs, so filling them in makes your templates easier to find and share.
Preview before you save
Test every change before you save it.
In the preview panel on the right, open the Mock patient selector and choose a mock patient or one of your past consults.
Click Generate preview.
Once you've made changes, use the Before / After toggle in the Preview dropdown to compare your current template with your edits side by side.
Your past consults are listed while they're within your history retention period.
ℹ️ Good to know
Previewing and the Template Advisor don't use an action, so test as often as you like.
Improve your template with the Template Advisor
Open the Advisor tab in the preview panel.
Optional: describe what's wrong or what you want in the Feedback box, e.g. "too long", "missing medications" or "only discuss social history".
Click Review template.
Read the Advisor summary and the suggestion cards. Each shows its priority, category, the section it changes and Why this matters.
Click Show change, then Apply or Dismiss.
Click Save template.
💡 Tip
Always check Show change before you click Apply, so a suggestion doesn't rewrite instructions you want to keep. Then preview again.
The Template Advisor is available for note templates only.
