Browse help topics
Troubleshooting and Security

Troubleshoot uploads and processing

Diagnose unsupported files, password-protected PDFs and ZIPs, stalled processing, blank previews, and invalid HTML bundles.

Updated October 25, 2026

Upload problems usually come from the file, the source link, the network, or the processing requirements for that format. Keep the original file until processing finishes and you have checked the preview or download.

File rejected before upload

Check that the file uses a supported extension and is no larger than 100 MB in the browser upload flow. Rename a file only when the extension is already correct for its real format. Changing .ppt to .pptx does not convert an old PowerPoint file.

Open the source on your computer. If the original application cannot read it reliably, export a fresh copy before uploading.

HummingDeck also checks that the file's content matches its extension. A file that is really something else, for example a web page saved as .pdf or a renamed export, is rejected with a message that it isn't a valid file of that type. Export the document again from the original application and upload that file.

Password-protected PDF or ZIP

Choose Download only when uploading a password-protected PDF or encrypted ZIP from your device. HummingDeck does not ask for the file password, decrypt it, or create a preview. A download card without pages is the expected result.

If you need a browser preview, use an unencrypted source only when your sharing policy permits it. Download-only is available for PDF and ZIP, not a single HTML file. A ZIP shared as download-only does not need an HTML entry page.

If a recipient cannot open a downloaded file, test the source locally with a compatible PDF reader or archive application. Check the password with the sender through a separate channel; do not put it in a Support ticket. See Help a recipient open a document.

The upload dialog accepts Google Docs, Slides, and Sheets editor links. For a document hosted elsewhere, download the file in a supported format and upload it from your device. You can also publish through the Google Workspace add-on or Canva integration.

For a Google Drive file, open it in Docs, Slides, or Sheets and paste that editor URL. A general drive.google.com/file link points to Google's file viewer. To import an editor link through the upload dialog, set the document's sharing to Anyone with the link can view. If that sharing setting is unsuitable, download the file and upload it directly.

Processing takes longer than expected

Large Office files, spreadsheets, and HTML ZIP bundles require more work than a simple PDF. Leave the document in the Library while processing continues. Repeated uploads create duplicate work and can make it harder to identify the final version.

If the state does not change after a reasonable wait, refresh the page once. Then collect the document title, file type, approximate size, upload time, and visible status for Support.

Preview is blank or incomplete

For Office files, export a PDF and compare the result. Missing fonts, unsupported embedded objects, damaged charts, or unusual page sizes can change conversion output.

For HTML:

  • confirm there is one clear entry page;
  • check relative asset paths;
  • include the required CSS, JavaScript, images, and fonts;
  • remove dependencies on a private server or local machine;
  • test from a static web server;
  • open the recipient link in a private browser window.

See HTML and ZIP upload requirements for the full package checklist.

Existing document fails after replacement

Confirm the replacement uses a supported format and still belongs to the intended document. If the page count changed, review the recipient preview and page analytics before relying on older comparisons.

See Replace a document without changing its links for the normal workflow and retained link behavior.

Do not delete the existing document simply to clear an error unless you are prepared to recreate its links and Room placement.

What to include in a Support ticket

  • Workspace and document title
  • File type and approximate size
  • Time of the attempt
  • Browser and operating system
  • Exact visible error
  • Whether the original file opens locally
  • Whether a smaller or PDF export succeeds

Do not attach confidential source material unless Support asks for a safe way to provide it.