Skip to main content

Writing note templates that work

Write clear template instructions, set template settings, preview and use the Template Advisor.

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.

  1. In the preview panel on the right, open the Mock patient selector and choose a mock patient or one of your past consults.

  2. Click Generate preview.

  3. 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

  1. Open the Advisor tab in the preview panel.

  2. Optional: describe what's wrong or what you want in the Feedback box, e.g. "too long", "missing medications" or "only discuss social history".

  3. Click Review template.

  4. Read the Advisor summary and the suggestion cards. Each shows its priority, category, the section it changes and Why this matters.

  5. Click Show change, then Apply or Dismiss.

  6. 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.


Did this answer your question?