The PDF widget allows you to embed a PDF file directly on Content pages. You can choose to upload a PDF from your computer or use an online-hosted PDF This enables your readers to view the entire PDF without leaving your Turtl Doc, keeping them engaged with your content.
In this article, we'll walk you through the basics of PDF widgets, including how to add, whitelist, adjust thumbnails, and add captions.
Add a PDF widget
Click the "+ Add content" button.
Select "PDF" from the Content menu.
Choose "Upload" to add a PDF from your computer, or "Embed" to insert a PDF that's hosted online.
Upload: Either click the arrow icon, drag the file from your computer into the area labeled "Drag and drop PDF," or click "here" to browse and select the file from your computer. The PDF will then appear on your Content page.
Embed: Paste the PDF URL and click "Upload".
Notes:
The URL needs to be a direct link to the document (e.g.,
www.mycompany.com/documents/my-report.pdf
). You can confirm it's a direct link by checking if the URL ends with ".pdf".PDF files stored in internal folders (such as '
file:///
') cannot be embedded in the Turtl Doc.
PDF widget thumbnail
Resize thumbnail
Missing PDF thumbnail
A thumbnail for a PDF will not load if the uploaded PDF is private.
To obtain a thumbnail:
Temporarily set PDF to public.
Add the PDF to Turtl again.
The thumbnail is obtained.
Set the PDF back to private.
Add a caption to PDF widget
Learn how to create a PDF widget caption.
PDF Whitelisting
To ensure Turtl is a secure and transparent system, any PDF you try to embed in your Turtl Doc using the PDF widget will be verified against a whitelist. If the PDF's hostname (the domain where the PDF is hosted) is on the whitelist, the PDF will be successfully uploaded to your document.
Example
This is your PDF URL: https://africau.edu/images/default/sample.pdf
The hostname is: africau.edu
If the hostname africau.edu
is not on the whitelist, the PDF cannot be embedded.
Please reach out to Customer Support, who will whitelist the hostname or upload your PDF to one of the following domains:
cdn.fs.turtl.co
assets.turtl.co
team.turtl.co
turtl.co
null