Clearer Text in ONLYOFFICE Desktop: Tune Font Hinting on Linux

If text looks soft in ONLYOFFICE Desktop Editors on Linux, first compare the editor’s Font Hinting modes at a normal zoom level; do not start by changing system-wide font settings. ONLYOFFICE documents three modes—As Windows, As OS X, and Native—and their effect depends on how fonts are hinted and rendered. If only one typeface looks wrong, check whether Linux and the editor can see the intended font before adjusting rendering.

Separate rendering softness from a missing font

Open the same document in another application and inspect the same text at a similar zoom. If text is blurry across your desktop, the issue is more likely tied to display scaling, the desktop environment, or graphics rendering than to an ONLYOFFICE preference. If the softness appears only in ONLYOFFICE, test its font hinting and zoom settings first.

Also distinguish a blurry typeface from a substituted one. Substitution often changes letter shapes, spacing, or line breaks; blur makes the expected letters look soft at their edges. ONLYOFFICE notes that documents may use a closest font substitute when the requested font is absent. A substitute can change layout, so check the font family name in the document toolbar before treating every visual difference as a rendering defect.

Compare the three Font Hinting modes

1. Open a document containing small body text and a few bold headings. Use the same page, same display, and a consistent zoom while comparing results.
2. Open File > Advanced Settings and locate Font hinting. The official ONLYOFFICE Document Editor advanced settings reference describes these modes: As Windows uses Windows-style hinting; As OS X displays text without hinting; Native uses hinting embedded in font files.
3. Try Native first, apply the setting, and inspect the same text. Then compare As Windows and As OS X one at a time. Keep whichever mode gives the clearest result at the zoom and display you actually use; no mode is guaranteed to look best on every Linux setup.
4. Check the editor’s zoom as a separate variable. Compare at 100% and at the zoom you normally use. If text looks clear at one zoom but soft at another, the issue may be how the page is scaled on screen rather than a damaged font file. ONLYOFFICE documents a default zoom range from 50% to 500%.

Change one setting at a time and use Apply if the dialog provides it. Close and reopen the document if the rendering does not refresh immediately. Avoid changing the editor’s font cache mode as a first fix: ONLYOFFICE describes it as a specialized setting and says it is not recommended to switch it without a reason.

Check that Linux can find the intended font

If only a particular family is affected, confirm that font is installed and readable. ONLYOFFICE lists /usr/share/fonts/ for fonts shared by all users and ~/.local/share/fonts or ~/.fonts for fonts installed for the current user. Its Desktop Editors font installation instructions say font files must have 644 permissions (-rw-r--r--); global installation under /usr/local/share/fonts requires root access.

For a user-level install, copy a legitimate font file into ~/.local/share/fonts, then refresh the fontconfig cache if the command is available:

mkdir -p ~/.local/share/fonts
cp /path/to/font-file.ttf ~/.local/share/fonts/
chmod 644 ~/.local/share/fonts/font-file.ttf
fc-cache -f ~/.local/share/fonts

Replace the example path and filename with the actual font file. The fontconfig fc-cache manual explains that the command scans font directories and rebuilds font information caches. You can check whether the system resolves a family with fc-match "Font Family Name". Then fully quit and relaunch ONLYOFFICE so it can refresh its available font list. Use fonts from a source whose license permits your intended use; do not install a random font file to test blurry rendering.

If fc-match resolves the expected family but ONLYOFFICE still uses a visibly different face, note how Desktop Editors was installed. ONLYOFFICE supports Linux packages as well as AppImage, Flatpak, and Snap builds; behavior can vary by packaging environment. As a diagnostic, compare with another supported installation method only if the font is visible to the host but not to the editor. This is a comparison test, not a guaranteed fix.

Verify the result and know when to stop

Reopen the same document and compare the same short paragraph at the same zoom. A useful result has distinct letter edges, consistent character spacing, and unchanged line wrapping where the font family is supposed to remain the same. Confirm the selected font name in the toolbar and check whether other applications remain clear.

• If one hinting mode improves ONLYOFFICE text, keep that mode and avoid further system changes.
• If the expected typeface was missing, confirm fc-match resolves it and that ONLYOFFICE displays that family after restart.
• If all applications look blurry, investigate the Linux desktop’s display scale or monitor settings; the editor’s font hinting option cannot correct blur across the whole desktop.
• If only one document remains affected, check its font family and whether that font is embedded or available on the system. A substituted font can alter appearance even when the rendering mode is set correctly.

These checks can isolate common causes, but they cannot make every font look identical across Linux desktops, monitors, and application builds. Judge the change by legibility in your normal workflow and preserve the document’s intended font and layout.

Open Advanced Settings from the File menu to reach the editor’s appearance controls.

Compare the documented Font Hinting modes on the same text and at the same zoom.

A font placed in a supported Linux font directory should be readable and discoverable by the system.

Use the same paragraph and zoom as a visual check after changing a rendering preference.