Troubleshooting
You are viewing help for Supervertaler for Trados — the Trados Studio plugin. Looking for help with the standalone app? Visit Supervertaler Workbench help.
Solutions to common issues with the Supervertaler for Trados plugin.
Plugin not loading
Symptoms: The TermLens panel does not appear in Trados Studio, or the plugin ribbon tab is missing.
Solutions:
Check Trados version –the plugin requires Trados Studio 2024 or later
Verify .NET Framework –ensure .NET Framework 4.8 is installed on your system
Reinstall the plugin –remove the plugin via Trados Plugin Management, restart Trados, then install it again
Check for errors –open Trados Plugin Management and look for error messages next to the Supervertaler plugin entry
After installing or updating the plugin, always restart Trados Studio completely (close all windows, not just the project).
"Could not load SQLite" or DLL errors
Symptoms: Error messages about missing DLLs or SQLite when opening settings or loading a termbase.
Solutions:
Restart Trados Studio after the first install. The plugin pre-loads its own SQLite DLL to avoid conflicts with other plugins, but this requires a clean startup
If the error persists, reinstall the plugin to restore any missing DLL files
Database locked / "cannot open database"
Symptoms: Error when trying to load or write to the termbase database.
Solutions:
Close Supervertaler Workbench if it has the same
.dbfile open. Two applications writing to the same SQLite file simultaneously can cause lock conflictsThe plugin uses read-only mode where possible to minimise conflicts, but write operations (adding terms) require exclusive access
Verify the
.dbfile is not on a drive that has gone offline (e.g., a disconnected network share)
If you share the database via a cloud-sync folder, ensure the file is fully synced before opening it in the plugin. Partially synced files can appear locked or corrupt.
Terms not appearing
Symptoms: TermLens shows no matches even though you know the segment contains terms that exist in your termbase.
Solutions:
Check the Read toggle –open TermLens Settings and verify the termbase has Read enabled
Verify the database path –ensure the path points to the correct
.dbfilePress F5 to force a full reload of your Supervertaler termbases from disk (note: F5 does not reload MultiTerm termbases)
Reload the database –click the gear icon in the TermLens panel to open settings, then close the dialog. This forces a reload of the termbase data
Check language pair –the termbase source/target languages must match the current Trados project languages
MultiTerm terms not appearing
Symptoms: Green chips from your MultiTerm termbases (.sdltb files) are not showing in TermLens, even though the termbases are attached to your Trados project.
Solutions:
Check your Trados project –verify that MultiTerm termbases are attached via Project Settings > Language Pairs > Termbases
Check the Read toggle –open Supervertaler Settings (gear icon) and make sure the MultiTerm termbase's Read checkbox is enabled
Check languages –the termbase's source and target languages must match the current project's language pair
Navigate to another segment and back to trigger a MultiTerm auto-refresh (F5 does not reload MultiTerm termbases — only segment navigation does)
When you add terms in MultiTerm, navigate to a different segment in Trados to trigger the auto-refresh. TermLens checks for file changes on each segment change.
See MultiTerm Support for full details.
AI features not working
Symptoms: Batch Translate produces no output, or single-segment translation returns an error.
Solutions:
Verify the API key –open AI Settings and confirm the key is entered correctly with no extra spaces
Check provider endpoint –ensure the provider's API endpoint is reachable from your network (no firewall or proxy blocking it)
Ollama users –make sure the Ollama service is running locally:
Then verify the endpoint in AI Settings (default:
http://localhost:11434)Custom provider –double-check the endpoint URL and model name in the Custom OpenAI-compatible settings
Check your API credits –some providers return errors when your account balance is zero
Database errors on Mac (Parallels)
Symptoms: Database locked errors, "cannot open database", or corrupt termbase data when running Trados Studio inside Parallels Desktop on a Mac.
Cause: Your Supervertaler data folder is on a Mac-side shared path (e.g., \\Mac\Home\Supervertaler). Parallels mounts Mac folders as virtual network shares, and SQLite databases do not work reliably on network filesystems — WAL mode (used by Supervertaler termbases) requires a local filesystem for correct locking.
Solution:
Move your data folder to the Windows side (e.g.,
C:\Users\<username>\Supervertaler)Copy your
.dbtermbase files from the Mac-side location into the new Windows-side folderUpdate the data folder path in Supervertaler settings, or delete
%AppData%\Supervertaler\config.jsonand restart Trados to trigger the first-run setup again
See Installation — Running on a Mac (Parallels) for the recommended setup.
Performance issues
Symptoms: The editor feels sluggish, or TermLens takes a long time to display matches.
Solutions:
Large termbases (50,000+ terms) may take a moment to index when the database is first loaded on startup. This is a one-time cost per session
Close and reopen the editor if the plugin feels unresponsive after a long session
Disable unused termbases –uncheck Read for termbases you do not need for the current project to reduce the matching workload
Reduce batch size in AI Settings if Batch Translate is slow or timing out
Still having issues?
Ask a question on the Supervertaler forum — the official community forum for both Supervertaler Workbench and Supervertaler for Trados
Check the GitHub Issues for known bugs, feature requests, and workarounds
Open a new issue to report a bug or request a feature, including:
Your Trados Studio version
The Supervertaler plugin version
Steps to reproduce the problem
Any error messages or screenshots
See Support & Community for all the ways to get help.
See Also
Last updated