Fix the “Download Failed” Error When Exporting a PDF from ONLYOFFICE

If ONLYOFFICE shows “Download Failed” after you export a document as PDF, first find out which part failed: PDF generation, transfer from ONLYOFFICE to your device, or the browser’s final save. A successful export should produce a non-empty PDF that opens and keeps the important page breaks, tables, and fonts. Try the checks below in order; each one narrows the cause without changing the original document.

Start by identifying your ONLYOFFICE version

In the online Document Editor, the documented route is File > Download as > PDF. “Save Copy as” saves a copy to the portal instead of downloading it to your computer. In Desktop Editors, use File > Save as and select PDF. The labels and available options differ across apps and versions, so do not assume an online menu is present in the desktop app. See ONLYOFFICE’s document download and print instructions and File tab guide.

If you are editing an existing PDF in the online PDF Editor, its download flow is also under File, but it is a different editor. Use the instructions for the app you actually have open.

1. Protect your edits before troubleshooting

Before repeating an export, save the source document. In the online editor, use Ctrl+S or File > Save if available, and wait for the save indicator to settle. ONLYOFFICE documents automatic saving for its online editor, but you should still confirm the current changes are saved before refreshing or closing a session. In Desktop Editors, save the working file normally first.

Then make a copy of the document and try the export on that copy. This gives you a safe test without risking the original. Avoid repeatedly clicking Export while a request is still running; overlapping downloads can make it difficult to tell which file succeeded.

2. Use a small test document to isolate the failure

Create a new one-page document with a short line of text and export it as PDF using the same app and device. Check whether the PDF appears in the browser’s download list or the folder selected in the desktop save dialog, and confirm the file size is greater than zero. Open it in a PDF viewer and make sure the text is visible.

  • The test PDF works: the export path is available. The original file may contain content or formatting that triggers a conversion problem, or its download may be unusually large or slow. Continue with a copy of the original and temporarily simplify heavy images, embedded objects, or complex layout one category at a time.
  • The test PDF also fails in the online editor: check browser downloads and try the alternate route below. If the problem continues across browsers or users, the online service or its integration may need attention.
  • The test PDF works in Desktop Editors but not online: the issue is more likely tied to the browser, online session, portal, or Document Server connection than to PDF export in general.

This comparison is a diagnostic clue, not proof of one root cause. Keep track of the app, browser, time, document size, and whether the failure affects one file or every file.

3. Separate PDF generation from the browser download

In the online editor, choose File > Download as > PDF once, then inspect the browser’s downloads panel. If a file is listed, use the browser’s “Show in folder” or equivalent action and check its size. A file that opens correctly means PDF generation succeeded; the remaining issue may be where the browser saved it or how the browser handled the download.

If the download is blocked, interrupted, or missing, check the browser’s download notifications and the operating system’s available disk space. If your browser or organization blocks downloads from the site, ask the administrator whether the site is allowed to download files. For a one-time test, use another supported browser on the same device, or another device on the same account. If it works there, focus on the first browser’s download settings, extensions, security software, or local storage rather than changing the document.

Private browsing can help determine whether an extension or stored site data is involved, but only if you can sign in and open the same document there. It does not repair a server-side export failure, and it may not be appropriate for managed accounts. Do not clear all browser data as a first step; that can sign you out of unrelated services.

4. Try an alternate route and compare the result

For a document in the online Document Editor, try File > Save Copy as and choose PDF if that format is offered. This saves a copy to the portal; it does not test the same browser-to-computer download path. If the portal copy opens, export likely produced a PDF and the direct download path is the narrower issue.

You can also try printing to PDF as a temporary workaround. ONLYOFFICE documents a Print option and notes that Firefox can print without downloading the PDF first. Choose a PDF destination in the print dialog if your browser or operating system offers one. In Desktop Editors, use the print dialog’s PDF option if available. Compare page count, page breaks, and any content near the margins with the original.

Print-to-PDF is not identical to exporting. It may apply print layout settings and can change page scaling or omit content outside the printable area. Use it only when the resulting file passes your own visual checks, especially for forms, spreadsheets, or documents with precise pagination.

5. If you use Desktop Editors, save to a simple local path

In Desktop Editors, choose File > Save as, select PDF, and save a copy to a folder you can write to, such as your Documents folder. Give it a short filename using ordinary letters and numbers. Do not save directly to a network share, synchronized folder, removable drive, or protected system directory during the first test. If the local copy works, retry the desired destination afterward; that comparison points to a destination or permission issue.

If the save dialog completes but no usable PDF appears, check that the folder is writable and has free space. Close a PDF viewer that may have the target file locked, choose a new filename, and try again. If only one source document fails while a basic test succeeds, make a working copy and test after removing or replacing unusually large or damaged media. Keep the original unchanged until you have verified the copy.

6. When an administrator should inspect the server

If every user sees the failure in the online editor, or both direct download and portal copy fail, provide your ONLYOFFICE administrator with the time of the attempt, the affected document’s approximate size, the browser and version, and whether a small test document also fails. For an integrated or self-hosted installation, the administrator should check the Document Server and platform logs around that timestamp, confirm the editor and storage platform can reach each other, and review recent proxy or network changes.

ONLYOFFICE’s troubleshooting reference maps certain editor errors to expired security tokens, dropped sessions, or save errors, and advises administrators to check DocService logs and callback reachability for save failures. Those messages are related diagnostics, not a universal explanation for every “Download Failed” alert. If the instance is behind a reverse proxy, verify its forwarded host and protocol headers against the current ONLYOFFICE proxy configuration guide. Administrators can follow ONLYOFFICE’s debug logging instructions to collect more detail, then return logging to its normal level after diagnosis.

Do not change JWT secrets, disable authentication, or expose the Document Server publicly as a test. Those changes can create security and integration problems while leaving the export fault unresolved.

How to confirm the problem is fixed

Export a small test document, then the working copy of the original. Confirm that each PDF has a non-zero size, opens without an error, has the expected page count, and preserves critical text, tables, images, and page breaks. If you used “Save Copy as” or Print to PDF, verify the file is in the intended portal or local folder and compare its layout with the normal export. When only one route works, record that distinction for your administrator; it points to the stage that still needs investigation.

Official references

Leave a Comment

How to Create and Send a Meeting Invite in Outlook

How to Create and Send a Meeting Invite in Outlook

Create an Outlook meeting invite, add required or optional attendees, choose a time, add Teams details, set recurrence, and check replies in new or classic Outlook.

How to Add a Character Limit to Cells in Excel

How to Add a Character Limit to Cells in Excel

Use Excel's Data Validation settings to set a maximum, minimum, exact length, or character range, then add clear prompts and error alerts.

How to Fix the “We Can’t Schedule the Meeting” Error in Outlook

How to Fix the “We Can’t Schedule the Meeting” Error in Outlook

Fix the Outlook “We can’t schedule the meeting” error by checking account support, refreshing Teams sign-in, and repairing the Classic Outlook add-in.

How to Change the Language in Office 365 (Microsoft 365)

How to Change the Language in Office 365 (Microsoft 365)

Change Office 365 menus, spelling and grammar settings, or keyboard input in desktop apps and Microsoft 365 for the web.

How to Auto-Forward Emails in Outlook 365

How to Auto-Forward Emails in Outlook 365

Learn how to auto-forward all or selected emails in Outlook 365 using Forwarding settings or Rules, plus how to stop forwarding and fix blocked external forwards.

How to Use Microsoft Editor in Word for Microsoft 365

How to Use Microsoft Editor in Word for Microsoft 365

Use Microsoft Editor in Word for Microsoft 365 to check spelling, grammar, clarity, and conciseness, review suggestions, and tune proofing settings.

How to Add an RSS Feed to Outlook 365 in Classic Outlook

How to Add an RSS Feed to Outlook 365 in Classic Outlook

Learn how to add an RSS feed to Outlook 365 in classic Outlook for Windows, find the correct feed URL, manage subscriptions, and fix common RSS issues.

How to Go to a Page in Word for Microsoft 365

How to Go to a Page in Word for Microsoft 365

Jump straight to any page in Word for Microsoft 365 with Ctrl+G or F5, relative page numbers, or the Navigation pane, with Windows and Mac shortcuts.

How to Add Contacts to Outlook on Web, Windows, and Mobile

How to Add Contacts to Outlook on Web, Windows, and Mobile

Learn how to add contacts to Outlook on the web, new Outlook, classic Outlook, and mobile, plus how contact syncing and CSV imports work.

How to Change the Microsoft Word Background Color or Add an Image

How to Change the Microsoft Word Background Color or Add an Image

Change a Word page color, add a picture background, remove either, and enable background printing on Windows or Mac with clear, current steps.