This article explains what to do when a file does not upload, a viewable rendition is missing, or content appears incorrectly or responds slowly in the Viewer.
A viewable rendition is the version of your file that you see and annotate on in Vodori. Word and PowerPoint files normally need to be converted into a viewable PDF. Uploading the source file, generating a rendition, and displaying it in your browser are separate steps.
- Identify the problem
- A Word or PowerPoint rendition is missing
- About custom fonts
- Embed your fonts
- Upload and display issues with complex PDFs
- Split a long PDF page into multiple pages
- The Viewer is slow when working with annotations
- Other layout issues
- Provide your own viewable rendition
- What to send to Support
Identify the problem
- The file does not upload: You receive an upload error or the source file is not available. Confirm that the file is not empty and opens correctly in the application used to create it. Record the error message and contact Support if the problem continues.
- The file uploads, but no viewable rendition appears: The source file is available, but the conversion needed for the Viewer has not completed successfully. Follow the rendition troubleshooting steps below.
- The file opens, but looks blank, partially displayed, or slow: The Viewer may be struggling to display the file's content. Follow the complex PDF and annotation guidance below.
A file can be a supported format and still encounter a conversion or display problem. File size alone does not predict whether a rendition will be generated successfully or how quickly it will display. Page dimensions, fonts, layers, graphics, and annotations can also affect the result.
A Word or PowerPoint rendition is missing
Automatic conversion can fail because of a temporary processing-service issue or because of the structure or features within a particular file. If the same unchanged file works on one attempt and fails on another, tell Support; that pattern does not by itself mean the file is too complex.
- Open the original file in Word or PowerPoint and confirm that its content displays correctly.
- Check File Formats and Text Recognition for supported Viewer formats. Being able to upload a file does not necessarily mean Vodori can generate a viewable rendition for it.
- In Vodori, open Details > Renditions, if available, to check whether a rendition exists. The Active label identifies the rendition used by the Viewer.
- If the rendition is missing or inaccurate, export a PDF from the original application using Save As or Export. Open the PDF and check every page or slide for correct fonts, layout, images, and readable text.
- Follow Provide your own viewable rendition below to upload that PDF when the document is eligible for a rendition change. You can keep the original Word or PowerPoint source file.
If multiple files are affected, the behavior is intermittent, or a manually prepared rendition does not help, contact Support with the details listed at the end of this article.
About custom fonts
Some fonts, like Times New Roman and Verdana, are available across systems. However, when you’re designing documents, you may use custom fonts to achieve a specific style.
Custom fonts, on the other hand, are not guaranteed to be available on all systems. When they’re not available, they’re replaced with a close match. This is usually what happens when you see a font-related issue in Vodori.
You have a few options, listed below, to help fix that issue.
Embed your fonts
Microsoft Office allows you to embed fonts in your files to ensure others who view the file see it as you intended. The process to embed fonts is simple but may vary depending on your operating system and which version of Microsoft Office you’re using, so see their help documentation for instructions.
Please note that embedded fonts must be in .TTF format. Vodori relies on Microsoft Office to pass the fonts from Microsoft Office to generated PDF files. At this time, Microsoft Office only accepts .TTF font files. File types of .OTF and Type 1 are not supported. You may need to convert .OTF font files to .TTF.
To determine what font types are used in your document:
- Save the file as a PDF
- Open the PDF in Adobe Acrobat
- Navigate to File > Document Properties > Fonts
- Each font and the font type will be listed
It's important to note that embedding fonts increases the size of your file, especially if your file uses multiple fonts and weights.
Upload and display issues with complex PDFs
A PDF can meet file-size requirements and still be difficult for the Viewer to display. Many layers, detailed vector graphics, gradients, unusual fonts, mixed page sizes, or one very long page can increase the work needed to display it. This can affect small PDFs as well as large ones. A PDF that opens correctly in another application may still display slowly or partially in Vodori.
Work on a copy and try these options:
- Export a fresh PDF from the original authoring application. Prefer Save As or Export to preserve the document's text and structure. Check that the exported PDF looks correct before uploading it.
-
Simplify complex artwork and transparency. Detailed backgrounds, overlapping transparent shapes, fades, and shadows can increase processing and display time, even in small PDFs.
Ask the document’s designer to simplify these effects in the original design file or flatten only the affected artwork into an image. Keep text separate and selectable so it remains available for highlighting in the Viewer. See Adobe’s transparency-flattening guidance for more information.
- Use normal page breaks. Export particularly long or wide pages as multiple pages within one PDF. See the steps below if only the PDF is available.
- Check the result. Keep the original and export a separate PDF for testing. Check that all content is present, text remains selectable, and text, images, colours, links, and QR codes still work correctly. Reducing file size alone may not resolve the issue.
If the original PDF itself displays poorly in the Viewer, uploading the same unchanged PDF as a manual rendition may not improve it. Contact Support if a simplified copy still does not display correctly.
Split a long PDF page into multiple pages
The preferred approach is to ask the author to export the original document with normal page breaks. This allows page boundaries to be placed between paragraphs or graphics.
If only the PDF is available, you can test a paginated copy using Adobe Acrobat on Windows with the Adobe PDF printer installed:
- Open a copy of the PDF in Acrobat and select Menu > Print.
- Choose Adobe PDF as the printer. In the printer properties or page setup, choose a suitable paper size, such as A4 or Letter.
- Under Page Sizing & Handling, select Poster.
- Adjust Tile Scale until the preview shows the content fitting across the page width and continuing vertically across several pages.
- For a PDF intended for on-screen review, set Overlap to 0 and turn off Cut marks and Labels.
- Select Print and save the result with a new filename.
- Check each page for missing content, awkwardly divided text or images, and text selection. If the breaks are unsuitable, ask the author to create proper page breaks in the source document.
See Adobe's instructions for tiling large pages and saving through the Adobe PDF printer. Menu names may vary by Acrobat version. Printing to PDF can change document structure, so direct export from the original application is preferred.
For a document that already has annotations: Ask Support to help test a copy before replacing the source file or rendition. Changing the number or size of pages may affect annotation placement. Page splitting may improve performance, but its effect should be checked on the affected document.
The Viewer is slow when working with annotations
Numerous highlight annotations, especially those covering long passages on a single long PDF page, can make scrolling and other Viewer actions slower. The type and extent of the highlights matter as well as the number of annotations; a specific annotation count is not a guarantee of performance.
- Use the annotation filters to display a smaller set, such as annotations from one author at a time.
- Check whether scrolling and other actions become more responsive. Filtering changes which annotations you see; you do not need to delete them to try this.
- For new comments, use another annotation type where it meets your review needs instead of highlighting large passages.
- For future uploads, prepare long documents as multiple pages where practical. For an existing annotated document, contact Support before changing the layout.
If filtering does not help, tell Support which actions are slow and approximately how long they take.
Other layout issues
- Complex elements: If you have a PDF or Illustrator file with complex vectors and gradients, you may see unexpected shapes and colors when you upload the file to Vodori. Try simplifying the complex elements to avoid those issues. For example, remove some shapes or gradients to reduce complexity, or save complex elements as images before using them in your file. Note that layered .PSD files will be displayed as a rasterized version (flattened with layer information removed).
- Unexpected characters: If you see unexpected characters in the highlighted text pulled into an annotation, that may be a sign that your file is corrupted. In particular, this can happen when you edit a PDF in Preview, the PDF viewer on macOS.
- In other cases, Preview has a tendency to corrupt PDF files, so we recommend making PDF edits in Adobe Acrobat instead.
- If all else fails, there may be an issue with the way the PDF was saved. Try making a minor change, re-saving the file, and re-uploading it into the system.
Provide your own viewable rendition
You can upload a viewable rendition when automatic conversion fails or the generated rendition does not accurately show the original document. This lets you retain the original source file while reviewing and annotating a PDF, PNG, or JPEG rendition.
Before you begin: You need permission to prepare the document, and the document must be in Draft and eligible for file changes. Workflows such as Modify Dates or Change Content Owner can keep the document Approved and do not make it eligible for a rendition change. If the Renditions tab or Upload option is unavailable, contact your administrator or Support.
- Open the original file in its authoring application.
- Use File > Save As or Export to create a PDF, then check that it accurately represents the source.
- In Vodori, open the document's Details screen and select the Renditions tab.
- Select Upload and choose the PDF, PNG, or JPEG file.
- Return to the Viewer and check the displayed content. The Renditions tab marks the rendition currently in use as Active.
See Upload a viewable rendition for more detail. If the document already has annotations, check with Support before changing its layout or replacing its rendition.
What to send to Support
If these steps do not resolve the issue, include:
- The document link or ID, version, and whether you are using production or sandbox.
- The original filename, file type, and file size.
- The date, approximate time, and time zone when the problem occurred.
- The exact error message or a screenshot, and your browser name and version.
- Whether the upload failed, a rendition is missing, or the Viewer is slow or partially displays the file.
- Whether the same unchanged file succeeds on another attempt, whether other files are affected, and which troubleshooting steps you tried.
For slow Viewer behavior, also describe the page layout, whether there are many highlights, and whether filtering annotations improves responsiveness. These details help Support distinguish a file-specific problem from a temporary processing issue.
Related help topics
Comments
0 comments
Article is closed for comments.