Inserting PDF files is a common action in Confluence. The native capabilities are limited, but there are alternative solutions to embed gorgeous pdf files.
PDF files are a natural piece of your documentation. Unfortunately, the native capabilities make the navigation clunky and difficult in your Atlassian host application.
A great way to make a Confluence user happy would be to provide an easy and quick pdf app. One that integrates with your Atlassian wiki and gives flexibility for both publishing and reading any type of documents.
These are the highlights that explain why your users will love PDF Embed for Confluence:
Start embedding pdf documents that your colleagues can’t wait to read.
Use cases for PDF files in 2021
PDF files don’t need introduction. Created in 1993 by Adobe as a way to easily share documents ready for printing regardless of operating system and application software, they have become the standard extension for finalized documents.
Hard copies have dwindled every year since the advent of the internet. And PDFs have lost some interest in favor of formats that are easier to scan and read on a screen. There are, however, no signs that the format will go away anytime soon.
Some of the most common use cases for pdf files include invoices, e-books, tickets, pre-printing proofs, contracts and agreements, as well as manuals, guidelines, and presentations. It’s time to supercharge your external visitors with the best experience browsing pdf documents in your most visited space. Particularly now that external collaboration for Confluence has just been announced!
Why attach PDF files in Confluence
Better search results
It’s a good idea to attach PDF files with business content to an organization’s Confluence wiki. In a traditional folder structure, search is limited to the file name. Now it will be easier for employees to find that employee handbook, slide deck, or customer contract in Confluence.
Access control
If a document is important, then it should be published in Confluence. Among other things, Confluence has the right permission schemes to make sure that documents can only be accessed by those who have the rights.
Preview attached files without downloading them
Many file and document management systems force users to download pdf attachments before they can be viewed. Confluence makes pdf files more transparent displaying the content without even a click.
Many important details can go unnoticed just because you’re hiding the document behind a card thumbnail!
See the difference in the image below. The same file is previewed on the left with the native macro, on the right with our app:
Avoid multiple downloads
Downloading a pdf several times is a classic example of digital waste. Instead, insert a pdf in Confluence and ensure that the attachment is perfectly navigable for any stakeholder.
While it’s great to create documentation that includes pdf files, you should know that there are some downsides to the native PDF macros in Confluence cloud.
These drawbacks include everything from missing functionality to a counterintuitive user interface and unexpected errors loading the file.
Non-intuitive UI to attach and preview pdf files
The standard flow for enabling pdf previews has two steps. First, you add the file to the page. Second, you embed it in the page. It’s not what anyone would expect, and Samantha is not the first confused rookie.
Let’s have another look at the flow.
First, the pdf file must be attached to a Confluence page
Second, the existing attachment must be called from within the PDF macro to insert the preview in the page that you’re editing.
And in this second step, you must recall the exact pdf attachment by file name and page name.
Last but not least, the navigation controls in the pdf viewer are also not very clean. The arrows on the left and right of the document navigate between different documents stored in the same page, but they suggest a presentation.
Files can’t be inserted as links
It’s a bit disappointing that PDF files must be inserted in Confluence as attachments and not from a remote URL. If you need to embed a pdf that is hosted online, you will need to download it and reattach it.
Sometimes the PDF macro in Confluence Cloud just doesn’t work
It’s unfortunate, but judging by Atlassian Community threads like this and this, the native macro is not that reliable.
Plus, this is what I got when I gave it a go with several pdfs in my test instance. A big no:
Here are some advantages of the new app for Confluence Cloud… beyond the important fact that it actually works.
Insert PDF files from a link…
With PDF Embed for Confluence, you simply have more options.
Sure, you can upload a file. But that’s not the only way.
Whether it’s from your company OneDrive or from a third-party, all you need is an https URL.
…or embed local files and existing attachments
Not every PDF you need will be online. That’s why URLs are only one among three methods for publishing pdfs your Atlassian wiki.
The other two are quite obvious: you can select an existing attachment in your Confluence page, or upload a file from your local drive.
Version control for internal documents
Forget about uploading the last version of a document to Confluence, every single time.
Instead, you can simply use a permanent link that automatically serves the latest version of the file. This is really easy to do with Google Workspace. You don’t even need to convert your slides, docs or sheets to a pdf file.
Services such as Dropbox also support it (albeit with some workarounds). Even for complex workflows like updating the exported version of an Adobe Illustrator design!
View PDF attachments as presentations
PDF files have traditionally been viewed with a vertical scroll, but I can think of many cases where a presentation format suits the content better. PDF Embed for Confluence gives you the ability to decide how to display the document and how users should navigate through its pages.
Control whether a pdf can be downloaded or not
Sometimes you want users to save a document. Sometimes you don’t. Besides backing up confidentiality, one of the interesting advantages of blocking downloads is that nobody will be able to refer to an outdated version.
How to insert PDF files in Confluence
To start publishing PDF files in Confluence, you simply need to:
How may we help?
We’re actively gathering requirements to improve this pdf Confluence integration. If there is any additional feature that would make your life easier, please contact us and we will discuss it internally in a matter of days!
Cookie | Duration | Description |
---|---|---|
_ga | 1years 19days 23hours 59minutes | This cookie is installed by Google Analytics. The cookie is used to calculate visitor, session, campaign data and keep track of site usage for the site's analytics report. The cookies store information anonymously and assign a randomly generated number to identify unique visitors. |
_gat_UA | 1 minute | Used to throttle request rate. If Google Analytics is deployed via Google Tag Manager, this cookie will be named _ . |
_gat_UA-44969175-9 | 1 minute | A variation of the _gat cookie set by Google Analytics and Google Tag Manager to allow website owners to track visitor behaviour and measure site performance. The pattern element in the name contains the unique identity number of the account or website it relates to. |
_gcl_au | 3 months | Provided by Google Tag Manager to experiment advertisement efficiency of websites using their services. |
_gid | 23 hours 59 minutes | This cookie is installed by Google Analytics. The cookie is used to store information of how visitors use a website and helps in creating an analytics report of how the wbsite is doing. The data collected including the number visitors, the source where they have come from, and the pages viisted in an anonymous form. |
CONSENT | 16 years 3 months 13 hours | YouTube sets this cookie via embedded youtube-videos and registers anonymous statistical data. |
Cookie | Duration | Description |
---|---|---|
_fbp | 3 months | This cookie is set by Facebook to display advertisements when either on Facebook or on a digital platform powered by Facebook advertising, after visiting the website. |
b3e783bb62 | session | This cookie is set by the provider Zoho. This cookie is used for collecting information on user interaction with the web-campaign content. This cookie helps the website owners to promote products and events on the CRM-campaign-platform. |
fr | 3 months | Facebook sets this cookie to show relevant advertisements to users by tracking user behaviour across the web, on sites that have Facebook pixel or Facebook social plugin. |
IDE | 1 year 24 days | Google DoubleClick IDE cookies are used to store information about how the user uses the website to present them with relevant ads and according to the user profile. |
NID | 6 months | NID cookie, set by Google, is used for advertising purposes; to limit the number of times the user sees an ad, to mute unwanted ads, and to measure the effectiveness of ads. |
test_cookie | 15 minutes | The test_cookie is set by doubleclick.net and is used to determine if the user's browser supports cookies. |
VISITOR_INFO1_LIVE | 5 months 27 days | A cookie set by YouTube to measure bandwidth that determines whether the user gets the new or old player interface. |
YSC | session | YSC cookie is set by Youtube and is used to track the views of embedded videos on Youtube pages. |
yt-remote-connected-devices | never | YouTube sets this cookie to store the video preferences of the user using embedded YouTube video. |
yt-remote-device-id | never | YouTube sets this cookie to store the video preferences of the user using embedded YouTube video. |
yt.innertube::nextId | never | This cookie, set by YouTube, registers a unique ID to store data on what videos from YouTube the user has seen. |
yt.innertube::requests | never | This cookie, set by YouTube, registers a unique ID to store data on what videos from YouTube the user has seen. |
Cookie | Duration | Description |
---|---|---|
_calendly_session | 21 days | Store user preferences |
_zcsr_tmp | session | Used for website security |
1e5a17c8ab | session | No description available. |
3eb9b21c5c | session | No description available. |
4662279173 | session | No description available. |
AnalyticsSyncHistory | 1 month | Used to store information about the time a sync with the lms_analytics cookie took place for users in the Designated Countries |
cookielawinfo-checkbox-functional | 1 year | The cookie is set by GDPR cookie consent to record the user consent for the cookies in the category "Functional". |
CookieLawInfoConsent | 1 year | Records the default button state of the corresponding category & the status of CCPA. It works only in coordination with the primary cookie. |
d4bcc0a499 | session | No description available. |
li_gc | 2 years | Used to store consent of guests regarding the use of cookies for non-essential purposes |
m | 2 years | No description available. |
zft-sdc | 12 hours | This cookie stores metadata ( entrances, source etc) of a session which is used by full tracking. (https://www.zoho.com/privacy/cookie-policy.html) |
zps-tgr-dts | 1 year | This cookie stores the session's metadata on your website. |
zsc | 30 minutes | Zoho Service Communication Key. |