Skip to main content

Template troubleshooting tips

Practical fixes for short notes, missing detail, unwanted sections, bracket issues, and template testing.

Written by Dr. Harvinder Power

Quick answer

If a template is not producing the output you want, change one thing at a time, regenerate a past session, and compare the result. Most template problems come from unclear headings, vague instructions, or trying to make one template do too many jobs.

If notes are too short

  • Add headings for the details you expect, such as history, objective findings, assessment, plan, safety-netting, and follow-up.

  • Use instructions like include relevant positives and negatives and do not over-compress clinical reasoning.

  • Regenerate with Nightingale or Wilkins if the session is complex and detail matters more than speed.

If irrelevant sections appear

Make omission instructions explicit. Instead of:

[Only include if mentioned]

Use:

[Omit this entire heading and section if this topic was not discussed. Do not write "none reported" or "not mentioned".]

If square brackets change into normal brackets

  • Type the brackets directly in the template editor.

  • If you pasted from another app, paste as plain text and re-add the brackets.

  • Avoid nested brackets inside another bracketed instruction.

  • Save, refresh, and reopen the template to confirm the brackets stayed as square brackets.

If the template is too hard to control

Split it. For example, use separate templates for initial assessment, follow-up, GP letter, and patient summary. One large template usually produces weaker outputs than focused templates.

If you are not sure whether the change worked

  1. Save the template.

  2. Open a previous session in History.

  3. Click Regenerate.

  4. Select the updated template.

  5. Review the new document next to the old one.

Regenerate creates a new document and does not overwrite the original.

If you need help from Motics

Send the template name, the session you tested on, what the template currently says, what the output produced, and what you wanted instead.

Did this answer your question?