Why Collabora Online fonts decide whether documents look right
Collabora Online lays out every document with the fonts installed on the server, not the fonts on the user's laptop. When someone opens a Word or ODF file in the browser and sees different line breaks, shifted page endings or a substituted typeface, the cause is almost always a font gap on the server side. Line breaks and pagination depend on glyph widths, so a missing or different font changes where text wraps, which can move tables, headers and page breaks even when the text itself is correct. Users rarely connect these differences to fonts, so they report them as broken documents.
Fidelity therefore depends on three things: which fonts the server can see, how the rendering engine finds them, and whether the same set is present after every update. Fonts are installed into the system template used by the editing engine, and some deployments can also use remote font configuration over HTTPS. Plan this work at three points. First, before rollout, by inventorying the typefaces used in your existing documents and comparing them with what the server ships. Second, when corporate typefaces are introduced, because licensing and distribution of those fonts must be settled before they reach the server. Third, after any Collabora Online update, because a new package or image can change rendering, so you should keep a set of reference documents and compare their output before and after each upgrade.
Ask your installer or partner to confirm three details in writing: the exact font list and licences in scope, the method used to install or serve them, and the test documents that will prove rendering matches your baseline. The sample fontserver from the Collabora project serves TrueType and OpenType fonts for remote font configuration and is intended for development and testing, not production, so production font delivery needs its own design. Collabora's fontserver README explains what the sample covers. Treat font work as an ongoing control, not a one-time install.
Which font source fits your environment
This table compares the three ways to make fonts available to Collabora Online: font files installed into the systemplate, remote font serving over HTTPS, and relying only on fonts already on the host. Read each row for when the option fits, who maintains the font files, and the main trade-off before choosing one or combining them.
| Font source | When it fits | Who maintains the fonts | Main trade-off |
|---|---|---|---|
| Installed into the systemplate | Fixed corporate font set that must render the same on every server and after every update | Your team, who copies font files into the systemplate and repeats the step after rebuilds or upgrades | Every change needs a server-side rebuild and a rendering check, and fonts must be licensed for this use |
| Remote font configuration over HTTPS | Several servers or a central font library that many instances should share | Whoever runs the font server, which you should place inside your own network and under your change control | Adds a service to run and secure, and the font source becomes a dependency for document rendering |
| Sample fontserver | Local development, proof of concept and testing of the remote font feature only | The open-source project, with no production support behind it | Not for production; the project describes it as intended for development and testing |
| Host fonts only | Documents that use widely available fonts, or air-restricted environments with no font distribution step | The operating system packages on each host | Documents using other fonts may reflow or substitute, so fidelity depends on what the host happens to have |
Installing into the systemplate or serving fonts remotely
Fonts installed in the systemplate are available to every editing session that Collabora Online builds from that template, which makes this the most direct route for corporate fonts that must look the same for all users. The systemplate is a template directory on the server that coolwsd uses when it prepares the environment for a session. Ownership matters here. The font files usually belong to your organization, so someone must confirm the license for each font, and someone must keep a current inventory of what is installed.
- Licensing: confirm that each font's license permits server-side installation and use by many concurrent users.
- Ownership: assign one team to add, remove and record fonts, and place the inventory under change control.
- Refresh after change: after adding or removing font files, refresh the systemplate using the procedure in your Collabora Online package documentation, then restart the service so new sessions pick up the change.
- Existing documents: test documents that depend on corporate fonts, because substitution changes line breaks and pagination.
- Updates: a package upgrade can replace template contents, so re-check custom fonts after every update.
Confirm the exact systemplate path and refresh command for your package, then open a test document that uses each corporate font in a fresh session after every change and every update.
Remote font configuration lets Collabora Online retrieve fonts from a separate HTTPS service instead of relying only on files on the local server. Collabora's sample fontserver is the reference for this approach, and it serves TrueType and OpenType font files. Its project documentation describes it as intended for development and testing, so treat it as a way to prove the configuration works before you design the production service.
- Formats: the sample serves TrueType and OpenType files. Confirm support for any other format before you rely on it.
- Transport: configure the endpoint with HTTPS so font traffic is protected in transit, consistent with how you protect the WOPI path.
- Trial scope: run the sample only in a non-production environment to confirm that requested font names resolve as expected.
- Configuration: the remote font setting belongs in the coolwsd configuration. Confirm the key names and syntax for your installed version before editing.
- Verification: open test files and compare the rendered output against a server where the same fonts are installed locally.
Record which font names resolved remotely and which fell back to substitutes. That list defines what the production font service must supply, so keep it with your rollout records.
A production font service has to meet operational requirements that the sample fontserver does not claim to meet. It should be an owned and monitored service inside your infrastructure, with access controls, versioned font sets and availability that matches the editing service it supports. Availability deserves particular attention, because an unavailable font service can cause substitutions across many documents at once, and users may not notice until a document is shared.
- Availability: run the service with redundancy and monitor it, since font retrieval affects document rendering for every session.
- Access control: restrict who can publish or change font sets, and log every change.
- Versioning: keep font sets versioned so you can roll back and compare against a known rendering baseline.
- License records: maintain a license record for each font the service delivers, and review it when fonts change.
- Network placement: limit access to the Collabora Online servers and keep the service off the public internet where your security policy requires it.
Before you point production at any font service, ask the provider or your own platform team to show how it handles each of these five points, and test a full set of corporate documents against it.
Setting up corporate fonts step by step
This sequence takes a set of corporate typefaces from a licensed inventory to a verified rendering baseline on every Collabora Online server. Each step ends with a check so that substituted fonts are caught before users see them.
Inventory fonts and confirm licensing
Export a sample of the templates, reports and shared spreadsheets your users work with, and list every typeface, weight and style they use, including fonts embedded in PDFs and older Office files. For each font, confirm with your legal or brand team that the license allows server-side use and rendering for your users, because a desktop license may not cover a shared server. Check: you have a written list of font families with a licensing decision recorded for each one.
Choose the font source
Decide whether fonts will be installed into the systemplate or served remotely over HTTPS. Installing into the systemplate suits a fixed set of corporate faces that rarely changes. Remote font configuration suits a larger or changing set that you want to manage from one place. Confirm in the Collabora Online documentation for your release which option is supported and how each is configured. Check: the choice is recorded with its reason, and the team knows which path or host will supply the files.
Install font files into the systemplate
If you chose the systemplate, install the approved font files on each Collabora Online server using the path and procedure in the installation guide for your package or image. Keep the same files on every node, because a server missing a font will substitute it without a visible warning. Set file permissions so the service user can read them. Check: list the installed files on each server and compare checksums with the approved copies, so that matching checksums on all nodes confirm the step is complete.
Publish fonts for remote configuration
If you chose remote font configuration, publish the approved font files over HTTPS from a location the Collabora Online servers can reach. Use a trusted certificate and restrict who can upload or change files, since the fonts become part of every rendered document. Collabora's sample fontserver, described in its README, serves TrueType and OpenType fonts and is intended for development and testing only, so plan a production source of your own. Check: request each file from a Collabora server over HTTPS and confirm it returns the expected file.
Restart or refresh the service
Restart or refresh the Collabora Online service as the installation guide directs for your deployment method, since a running process may not pick up new fonts. In a cluster, restart nodes one at a time where you can, and confirm each node returns healthy before moving to the next. Mixed states across nodes can produce documents that look different depending on which server opened them. Check: every node reports healthy, and the font list on each node matches the approved set from the previous steps.
Test documents in each format
Open test documents in each format your users rely on, including docx, xlsx, pptx, OpenDocument files and PDFs with embedded fonts. Use documents that apply the corporate faces directly, beyond the default fonts, and open them through your host application in the browser. Check the font name in the document properties or the font selection box for each file. Check: the corporate font appears in every format tested, and no document shows a substitute. Keep the test files as a reference set.
Record a baseline and repeat after updates
Record the test results as a baseline: which documents were tested, which fonts rendered correctly, and the cause of any substitution. Store the baseline with the font inventory, and add the same test set to your update checklist, because a Collabora Online or operating system update can change how fonts are handled. Repeat the tests on a staging server before each production rollout. Check: the next update has a documented pass or fail against the stored baseline before it reaches users.
Where font fidelity breaks after installation or updates
Font problems in Collabora Online rarely show up on the day of installation. They appear when a second node is added, when a document arrives with a font name the server does not recognize, or when an update changes how text wraps. The cards below list the failure points worth checking before and after each change.
Missing fonts on some servers
In a cluster, each Collabora Online server renders documents with the fonts installed on that host. A node built from an older image or package set can lack a font that its neighbors have, so the same document may paginate differently depending on which pod or server handles the session. Compare the font list on every node against a reference build, and confirm that new nodes are provisioned from the same source before they receive traffic.
Font name substitution
A document stores the font name chosen by its author, and the server substitutes a different face when that name is not installed. Names can differ by spacing, vendor suffix or style variant, so a font that looks installed on a desktop may still be replaced on the server. Collect the font names used in your most common templates and check each one against the installed names, not the file names.
Development fontserver left in production
Collabora's sample fontserver serves TrueType and OpenType fonts for remote font configuration and is intended for development and testing, not production. A test instance that was never replaced can become a silent dependency, and its availability, access controls and font licensing will not have been reviewed for production use. Confirm which remote font sources the production configuration points to and retire any development service from that path.
Layout shifts after updates
A Collabora Online update or a new fonts package can change line breaking, metrics or fallback behavior, so a document that paginated correctly last month may reflow after the change. Treat every server update and every fonts package change as a rendering change. Keep a set of reference documents with known page counts, and compare rendered output on a staging server before promoting the change.
Licensing gaps for corporate typefaces
Corporate typefaces are often licensed for use on specific devices or for specific document uses, and a license for desktop installation does not automatically cover server-side rendering or embedding in documents served to other users. Ask your legal or brand team to confirm in writing that each typeface may be installed on your servers and used for rendering in a hosted editor. Record the license terms next to the font files in your configuration repository.
Browser and server expectations differ
The browser displays the document with the fonts it can load, while the server uses its own font set to lay out pages, calculate line breaks and produce PDF exports. A document can look correct on screen and still export with different pagination, or the reverse. Test the same document in the browser and in each export format, and check that the fonts shown in the client are also available to the server that performs conversion.
Keeping corporate font files inside your controls
Treat every font file you give Collabora Online as input to a parser, not as passive data. Fonts are read and interpreted by the rendering engine every time a document that uses them is opened, so a malformed or malicious font file is a risk to the server that renders it. Only fonts from sources your organization has vetted should reach the system template or a remote font service, and that vetting should be written down as part of your font inventory. Ask who approves additions, how files are checked before they are copied in, and how a font is removed if a problem is found later.
Remote font delivery adds a network path to that trust chain. Collabora's sample fontserver, described in the CollaboraOnline/fontserver README, is intended for development and testing rather than production, so do not expose it as your production font source. If you run your own font service, restrict it to internal hosts, allow only the Collabora servers to reach it, and serve it over HTTPS. Apply the same protocol and TLS practices to the font service URL that the Nextcloud administration manual recommends for the Collabora server URL, namely matching protocol with the Nextcloud installation and preferring HTTPS. Confirm with your security team which certificate authority and cipher policy apply to internal endpoints.
Licensing and access control for the font files are the buyer's responsibility, and you should confirm them before deployment rather than assume a font may be redistributed to every rendering server. Check each font's license terms, decide which users or documents may depend on which fonts, and record that decision with the service owner. Assign ownership of the font service to a named role in your operations team, covering who patches the host, rotates its certificates, reviews what it serves, and answers when a document renders incorrectly. Without a named owner, the font service tends to drift from the approved inventory after the first update.
Checking rendering after each Collabora Online update
What documents should I use to check font rendering after a Collabora Online update?
Use a fixed reference set built from your organization's own documents, kept under version control and reused for every update. Include at least one file for each format your users open, such as docx, xlsx, pptx, odt and PDF, and make sure each file uses the corporate fonts and the fallback fonts your users actually see. Store the originals with a short note on which fonts each file depends on, so a failed check can be traced to a specific font rather than a vague sense that something looks different. Your own documents will surface problems that a generic sample set misses, because they reflect your templates, your tables and your font choices.
How do I compare rendering before and after a Collabora Online update?
Run the same reference set through a staging instance on the current version and again on the target version, then compare the outputs side by side. Staging should match production in font configuration, WOPI host settings and the Collabora Online package or image tag, so differences come from the update itself. Export each document to PDF on both versions and compare the pages visually, looking for substituted glyphs, shifted text and changed spacing. Keep the rendered PDFs with the update record so the comparison can be repeated or reviewed later by your team or an auditor.
How do I confirm my fonts survived a Collabora Online upgrade?
Check that the fonts are still installed in the systemplate and that the remote font configuration still points to the right source after the upgrade. For package installs, confirm the font files and any font configuration in the Collabora Online configuration are unchanged, and for Docker or Kubernetes deployments, confirm the image tag and any mounted font volumes or configuration maps still apply. Open a reference document and check that the fonts reported in the document match the ones you installed. Treat a missing font as a failed check even when the document still opens, because the layout will look correct until a line break or table width changes.
Which layout details should I check in Writer, Calc and Impress after an update?
Check the features most sensitive to font metrics: line breaks, pagination, table widths and text fit. In Writer, look at where page breaks fall, whether headers and footers stay aligned, and whether long paragraphs wrap at the same points. In Calc, check column widths, cell text overflow, number formatting and printed page breaks. In Impress, check text boxes for overflow, title placement and whether text stays inside placeholders. Compare each check against the staging baseline rather than against your memory of how the document should look, because small differences are easy to miss when reviewed by eye.
Which font names should I record when a document opens?
Record the font names the document reports for each reference file, both before and after the update. Compare the list against the fonts you expect, noting any name that has changed, any name that is missing and any substitution that appears where a corporate font should be used. A stable record makes it possible to spot a substitution introduced by an update even when the rendered page looks close enough at a glance. Keep the list with the reference set so that the next update compares against a known baseline, not against whatever the previous version happened to show.
What rollback path should I agree before a Collabora Online update?
Agree the rollback steps before the update starts, and name who can decide to roll back and within what window. Keep the previous package version, image tag or configuration backup available so the earlier state can be restored without rebuilding the server. Define the failed checks that trigger a rollback, such as a missing corporate font or broken pagination in a document your users rely on, and decide whether a known substitution can be accepted for a limited period. Confirm the rollback steps in staging first, and record the decision and the reason in the change record so the outcome is traceable.
What to confirm before you rely on remote fonts
Remote font delivery sits outside the parts of Collabora Online that most teams test by default, so its behavior depends on the version, the subscription and the way your servers are built. The cards below list the points to settle with Collabora or in your own environment before users depend on fonts that arrive over the network.
Supported delivery method
Confirm that the font delivery method you plan to use is supported for your Collabora Online version and subscription. The sample fontserver is intended for development and testing, so a production design needs written confirmation from Collabora before you build on it. Ask which configuration keys and transport settings are covered by support and which are your responsibility.
Font formats your documents need
List the font families and formats your documents actually use, then confirm which of them the remote font configuration serves. The sample fontserver handles TrueType and OpenType files, so check whether any corporate fonts are shipped in other formats or are licensed only as web fonts. Test a representative set of documents rather than assuming coverage from the font list.
How font updates are versioned
Find out how a changed font file is identified and rolled out. A replaced file with the same name can produce different rendering on servers that cached the old copy, so ask how versions are named and how clients learn that a font has changed. Agree on a change process that records which font build each document was last checked against.
Whether the font service needs high availability
Decide how much a font outage would matter for your users. If the font service is down, editing may fall back to substitute fonts, which changes layout for documents that depend on corporate typefaces. Ask Collabora how the font service behaves when it is unreachable and whether it can be placed behind redundant infrastructure within your design.
Identical fonts across cluster members
When several Collabora Online servers serve the same documents, each member must render with the same fonts. Confirm how you will keep the font set identical across nodes, whether through a shared source, configuration management or image builds, and how you will detect drift after a node is replaced or rebuilt.
What the support plan covers
Ask in writing whether font configuration, font-related defects and rendering problems fall under your support agreement, and which service levels apply. Clarify who investigates a fidelity issue when the cause could lie in the font service, the document, or your proxy, and what evidence Collabora expects you to provide.
Questions buyers ask about Collabora Online fonts
How much work does font management in Collabora Online take?
The effort depends on how many corporate typefaces you must support, how long the licensing review takes, how many Collabora Online servers need the same fonts, and how often you update. A small set of licensed fonts on one server is a contained task. Each additional typeface adds files to package, test and track, and each additional server adds a place where fonts can drift apart. Ask any partner to split the quote into a one-time setup (font inventory, licensing review, initial installation and rendering tests) and a recurring part (re-checking fonts after each Collabora Online update and adding new faces). Make sure the quote states which of those items it covers.
Can our team manage Collabora Online fonts without outside help?
Yes, if you have a named engineer who can install font packages on the Collabora Online host, edit the systemplate, and compare rendered output against a reference set of documents. The work becomes harder when fonts must be licensed for a server environment, when several servers must match exactly, or when the same person is not available for each update. Collabora Online is licensed under MPL-2.0, but that license covers the server code and does not decide whether you may install a given commercial typeface on your servers, so the licensing review belongs to your legal or procurement team in either case.
What do we need to provide before font work starts?
Prepare four things before any work begins. First, the font files you intend to use, with the license terms for each typeface and proof that you hold the right to install them on servers. Second, a set of sample documents that represent how your staff work, including the Microsoft Office files and PDFs that currently look wrong or differently spaced. Third, a staging instance of Collabora Online that matches production as closely as you can make it. Fourth, a named owner on your side who can approve licensing decisions and sign off on rendering results. Without the owner, decisions about which font substitutes are acceptable will stall the project.
Can we run the sample fontserver in production?
No. The sample fontserver from the CollaboraOnline project serves TrueType and OpenType fonts for the remote font configuration feature, and its own documentation states that it is intended for development and testing, not production. Use it to prove that remote fonts load and render as expected in a lab. For production, plan a font delivery path that you control, with HTTPS in front of it, access limited to your Collabora Online servers, and versioned font files that match your licensing records. Check the fontserver README before you start, because its scope may change between releases.
How do font checks fit into our Collabora Online update cycle?
Treat font checks as a required step in every update, not an optional extra. Collabora publishes point releases on its branches, and the 25.04 release notes show that the branch kept receiving point releases well after its first release, so updates will be frequent. Before you roll a new version to production, render your reference documents on staging, compare pages, tables and line breaks against the approved output, and confirm that the remote font configuration still loads. Keep a record of each result so that an unexpected change can be traced to either a Collabora Online update or a font change.
Which fonts are most likely to cause rendering differences?
Differences usually appear where a document uses a font that is missing on the server, so LibreOffice falls back to a substitute with different metrics. Corporate typefaces, custom Office fonts and older Windows fonts are the usual causes. Metric differences move line breaks, page breaks and table widths, which matters most in contracts, forms and regulated reports. Ask your team to list the fonts found in the documents that matter most, then confirm which of them are installed, licensed and tested. Fonts that appear in only a few legacy files can often be handled with a documented substitute if the business owner accepts it.
How DeployOpen scopes and delivers font configuration
DeployOpen approaches font management in Collabora Online as a scoped piece of work inside your own infrastructure. We start from the fonts your users rely on, confirm how documents are authored and exchanged, and then plan the installation, remote configuration and rendering checks in writing before any change is made.
How we scope
- Inventory the fonts used in your existing documents, templates and brand guidelines, and record licensing for each one.
- Agree in writing which fonts go into the systemplate and which, if any, are served through remote font configuration.
- Confirm the Collabora Online server, operating system and deployment method so font steps match your environment.
- Engagements are fixed-scope, with deliverables and timelines agreed in writing before work starts.
How we build
- Install approved font files into the systemplate and rebuild it, recording the exact steps for your servers.
- Configure remote font sources over HTTPS where your design calls for them, with access limited to your network.
- Test rendering of representative Word, Excel and PowerPoint files against the reference copies your users created.
- Document how font changes interact with Collabora Online updates, so the rendering check runs again after each release.
How we hand over
- Provide a runbook covering font installation, systemplate rebuilds, configuration keys and rollback steps.
- Deliver the test document set and a checklist that your team can rerun after every update.
- Walk your operators through the rendering checks and the points where a font problem is most likely to appear.
How we support
- Ongoing support, upgrades and continuous testing are available as a retainer that covers font checks after new releases.
- Retained support can include reviewing rendering results after each Collabora Online update before users see changes.
- Ask any provider to confirm in writing who maintains the font files, licenses and the test set after handover.

