Which of these is happening? Jump straight to the section you need.
Lyrebird is slow to open from the Best Practice toolbar
Best Practice freezes or closes unexpectedly while you're using Lyrebird
Each section explains what's happening and lists the fixes to try, in order. The fixes themselves are written out in full under Troubleshooting steps.
Lyrebird is slow to open
When you open Lyrebird from the Bp toolbar, it runs in a small built-in browser window on your computer, and it has to share your computer's memory with Best Practice itself. Slow loading almost always comes down to one of those two things — a cache that has grown too large, or too little memory left for the window to open into.
A good sign this is your issue: Lyrebird is fine first thing in the morning but noticeably slower by late morning or after lunch. That pattern almost always means patient files have accumulated through the session.
What to try, in order
You can stop as soon as things improve — most practices find the first one makes an immediate difference.
Clear the Lyrebird cache — the most common cause, and it resolves this for most practices
Refresh the Lyrebird integration — worth doing if patient details also aren't pulling through properly
Ask your IT provider to restart the Best Practice server — if several people at the practice are affected at once
Check your hardware and system requirements — if none of the above has helped
Still slow after all of those? Please get in touch — there's a short list of details that help us pick it up quickly.
Best Practice freezes or closes unexpectedly
This section is for you if Best Practice closes on its own, stops responding, or shows an error box like the one below while you're using Lyrebird.
Will I lose my consult?
Usually not — but check your Lyrebird History page before you do anything else. Completed consults save there automatically, and a consult that was interrupted partway through is often still there and can be rebuilt.
Open Lyrebird in a normal browser at app.lyrebirdhealth.com rather than through Best Practice, and click History
Find the consult by date and time — consults are listed newest first
If you see an entry under Retrieved Consult, open it and select Regenerate to rebuild your note
Check this promptly. History only keeps consults for your storage period — 7 days by default, adjustable under When should Lyrebird delete saved items? in Settings. Once a consult passes that period it's permanently deleted and can't be recovered.
If the consult isn't in History at all and is still within your storage period, it may not have been saved. How to recover a lost or missing consult walks through this in full, including a short video. If you believe a consult should be there and isn't, contact us with the date and approximate time — please don't include the patient's name, as we don't need patient details to look into it.
Why this happens
Best Practice can only use a limited amount of your computer's memory, regardless of how much the computer has. Every open patient file uses part of that allowance, and the Lyrebird window needs its own share. As that limit is approached everything slows down — and if it's reached, the window can freeze or Best Practice can close altogether. It's the same underlying cause as slow loading, which is why the fixes overlap.
A good sign this is your issue: crashes cluster in the busier parts of the day and clear after a restart, or happen when you've had a lot of patient files open at once.
A second known cause — ending a consult from the Best Practice screen
Best Practice support have identified a workflow that can also cause this, and are working on a fix. It looks like this:
You open a patient record and open Lyrebird
You start a consult
You move out of Lyrebird to do something else in Best Practice — writing and printing a script, for example
You end the consult from the Best Practice screen while the Lyrebird window is still running
If that matches what you were doing, please let us know.
What to try, in order
Restart Best Practice completely — daily as a habit, and again during breaks if you have a heavy list
Clear the Lyrebird cache — a large cache adds to the memory the window needs
End consults in the Lyrebird window before moving back into Best Practice
Ask your IT provider to restart the Best Practice server — if several people at the practice are affected at once
If the crashes continue, the most useful thing you can do is send us your Bp error log, along with the details listed here. Crashes are harder to diagnose than slowness, so that detail really matters.
The Lyrebird window is blank, or you see a WebView error
Best Practice displays Lyrebird using a Microsoft component called WebView2 — the same component Best Practice uses for other pages inside the application, such as help links and the latest news panel. When you see a WebView error, it's this component that has run into trouble, not Lyrebird itself.
What it looks like
A WebView error message when you click the "L" logo
The Lyrebird window opens blank or white and never loads
Lyrebird opens fine the first time, but fails when you close it and try to open it again
Other parts of Best Practice that display web pages — help links, latest news — also stop working
A quick way to tell: if those other Best Practice pages are broken too, the problem is with the WebView component across Best Practice as a whole rather than with Lyrebird. That's useful to mention when you contact us or your IT provider.
What to try, in order
Restart Best Practice completely — closing just the Lyrebird window isn't enough, the component needs a fresh start along with Best Practice
Clear the cache using Method B (deleting the EBWebView folder) — this is the more thorough of the two methods and the right one for WebView errors specifically
Please don't edit the Windows registry or change folder permissions yourself. Some WebView2 fixes circulating online involve both. Leave these to your IT provider — they carry real risk if applied incorrectly.
Some setups see this error return even after all of the above, particularly practices running Best Practice on terminal servers or virtual desktops. If that's you, please contact us rather than continuing to work around it — send us your Bp error log and the details listed here.
Troubleshooting steps
These are the fixes referred to in the sections above. If you've landed here directly, start with the section that matches what you're seeing — it will tell you which of these to try and in what order.
Step 1 — Clear the Lyrebird cache
Like any browser, the Lyrebird window saves temporary files — a "cache" — so things load faster next time. Over months of use those files build up, and past a certain point they stop helping and start getting in the way. Clearing them gives Lyrebird a clean start.
This is the most common cause of slow loading and resolves it for most practices.
Method A (quickest)
Open Lyrebird inside Best Practice by clicking the "L" logo in the toolbar
Right-click anywhere in the Lyrebird window and choose Inspect
Click the Application tab along the top
Under Storage, click Clear site data
Close the Lyrebird window and open it again
Method B (if Inspect isn't available, and for WebView errors)
Some practices have the Inspect option disabled. If so, you can remove the files directly. This is also the method to use for a WebView error.
Close Best Practice completely
Press Windows + R together, type
%APPDATA%and click OKIn the file path at the top of the window, click on AppData
Open the Local folder, then the Best Practice folder
Delete the folder named EBWebView
Reopen Best Practice, open a patient file, and open Lyrebird
Deleting this folder is safe — it contains only temporary files, and Best Practice recreates it automatically.
What to expect: the very first load after clearing will take a moment while it rebuilds. Every load after that should be quicker. The files gradually build up again over time, so it's worth repeating this every few months if you notice things slowing down.
Step 2 — Reduce the number of open patient files
Every patient file you leave open uses part of Best Practice's memory allowance, and Lyrebird needs some of it too. When lots of files are open at once there's little left over, so Lyrebird takes longer to open and can freeze.
Aim to keep no more than 3–5 patient files open at a time
Close patient files once you've finished with them rather than leaving them open in the background
Step 3 — Restart Best Practice completely
The memory issue above doesn't fully clear when you close individual patient files — some of it accumulates across the whole session. Restarting Best Practice releases all of it at once and gives Lyrebird a clean environment to open into. It's also the quickest way to recover if things have already slowed down mid-clinic.
Restart Best Practice at least once a day — first thing in the morning works well as a habit
Close it during breaks, particularly over lunch
Closing only the Lyrebird window is not the same thing — Best Practice itself needs to close and reopen
Step 4 — Refresh the Lyrebird integration
Best Practice and Lyrebird maintain a connection so that Lyrebird knows which patient you have open and can pull their details across. Occasionally that connection gets into an unhealthy state — usually after an update, a server restart, or a network interruption. Lyrebird keeps working, but spends longer than it should re-establishing the connection each time it opens.
Try this step if: Lyrebird is slow and patient details aren't pulling through properly, or the "L" button isn't behaving as expected.
You'll need Best Practice administrator access:
In Best Practice, go to Setup → Configuration → Database → Setup third-party integration
Search for Lyrebird Health, untick it, then tick it again, and click Save
Open a patient record to check whether you're prompted to log in again
You may need your practice manager or IT provider to do this if you don't have administrator access. These steps also appear in the BP Integration FAQ.
Step 5 — End consults in the Lyrebird window
If you need to do something in Best Practice partway through a consult — write a script, print a document — finish and close the consult in the Lyrebird window first, then carry on in Best Practice. Ending the consult from the Best Practice screen while Lyrebird is still running is a known trigger for crashes.
Step 6 — Check your security software
Some antivirus and endpoint protection tools interfere with WebView2, the component Best Practice uses to display Lyrebird. Your IT provider can test whether this is the cause by temporarily excluding Best Practice from scanning.
Step 7 — Repair or reinstall the WebView2 component
This is a task for your IT provider. Best Practice have published their own steps to troubleshoot this issue. Please don't attempt registry edits or permission changes yourself.
Step 8 — Ask your IT provider to restart the Best Practice server
If several people at the practice are affected at the same time, the problem is more likely to sit with the server than with any individual computer. Ask your IT provider to restart the Best Practice server outside clinic hours.
Step 9 — Check your hardware and system requirements
If nothing above has helped, it's likely something in your practice's hardware or network setup. The single biggest factor is whether workstations are running a solid state drive (SSD) rather than a mechanical hard drive — Lyrebird reads and writes a large number of small temporary files each time it opens, which is exactly the workload mechanical drives handle least well.
Ask your IT provider to check your setup against Best Practice Software's recommended specifications.
Sending us your Bp error log
Best Practice keeps its own error log, and sending it to us is the single most useful thing you can do for a crash or a persistent WebView error. It records what the software was doing at the moment things went wrong, which we can't see from our side. You can find it and send it yourself in about a minute, without waiting on your IT provider or Best Practice support.
Finding and sending your Bp error log to Lyrebird Support
Finding the error log
Hold down the Windows key and press R. A small box called Run will appear. Copy the path below into it exactly as it is written, then press Enter. You can also paste the same path into the address bar of any open folder.
C:\ProgramData\Best Practice\Log
If you can't find the folder, contact your IT team — on some setups it sits in a different location or on the server
A folder will open. Look for the file named BPSError.
Sending the error log
Attach the BPSError.log to an email and send it to [email protected].
Please include the date and approximate time of the crash so we know where to look in the file.
These files can be large, often several megabytes covering weeks of activity. If your email won't send it, open BPSError, scroll to the very bottom, copy the last few entries and paste them into your email instead — the most recent entries are the ones we need.
A note on privacy: the error log occasionally includes text from a consultation note that Best Practice was saving at the moment the error occurred. Please treat the file as you would any other document containing patient information, and send it only to the address above. Once the file is no longer required for troubleshooting it is deleted from our system.
What to tell us when you get in touch
Whichever of the three problems you're seeing, these details let us pick it up straight away:
What you were doing at the time — starting a consult, saving a note, generating a document
The date and approximate time it last happened
How often it happens, and whether it builds through the day
Whether it affects one computer or several, or everyone at the practice
Your Best Practice version and Site ID, and whether your practice server is on site or hosted remotely
Whether you're on a terminal server, virtual desktop or a standard PC
Which of the steps above you've already tried
Your Bp error log, for a crash or a WebView error
A couple of extras depending on what you're seeing:
If Lyrebird is slow: roughly how long it takes to open, whether that's consistent or occasional, and whether it's worse at particular times of day
If you're seeing a WebView error: the exact wording of the error or a screenshot, and whether other Best Practice web pages are affected too
Please don't include patient names or other patient details — we don't need them to investigate, and the date and time are enough for us to find the right records.
Not seeing your question?
Our support team is happy to help.
Live Chat: click the blue LiveChat icon in the bottom right corner of Lyrebird
Email: [email protected]
Phone: +61 483 964 067







