FAQ: EPUB Reader for Confluence — Everything You Need to Know
Confluence is where your team stores knowledge, documents, and reference materials. But when it comes to reading long-form content like eBooks, technical manuals, training guides, or policy documents distributed as EPUB files, teams often hit a wall. Confluence's native attachment viewer can display images, PDFs, and Office documents, but it does not render EPUB files. That means every time someone needs to reference an EPUB, they have to download it, open it in a separate application, and switch back and forth between their reader and Confluence.
EPUB Reader for Confluence removes that friction entirely. It adds a dedicated macro that embeds a full-featured eBook reader directly on any Confluence page. Your team can open, navigate, and read EPUB documents without ever leaving the browser. Whether you are distributing employee handbooks, sharing research publications, or making training manuals available alongside project documentation, EPUB Reader for Confluence keeps everything in one place.
This FAQ covers the most common questions teams ask when evaluating EPUB Reader for Confluence, from how it works and what formats it supports to embedding workflows, mobile reading, navigation features, and file size considerations. For the complete setup and configuration walkthrough, visit the EPUB Reader for Confluence usage guide.
What does EPUB Reader for Confluence do?
EPUB Reader for Confluence is an Atlassian Marketplace app that adds eBook reading capability directly inside Confluence. Once installed by your administrator, it provides a macro that you can place on any Confluence page to embed and read EPUB files. Instead of treating EPUBs as opaque attachments that must be downloaded and opened externally, the app renders the full contents of the EPUB -- chapters, text, images, and styled layouts -- inside a purpose-built reader interface.
The reader opens in a full-screen overlay within your Confluence browser tab. This means you get a clean, distraction-free reading environment while remaining logged into Confluence and connected to your team's workspace. When you close the reader, you return to the Confluence page exactly where you left off. There is no context switching, no separate application to install on your computer, and no need to manage local copies of files that might be outdated.
For teams that use Confluence as a central knowledge repository, this is particularly valuable. You can store employee onboarding guides, compliance manuals, product documentation, and reference publications as EPUB attachments on the relevant Confluence pages. Anyone with page access can then read those materials immediately, with full navigation and search capabilities, without needing external software. This also means that access control is handled entirely through Confluence's existing permission system -- if someone can see the page, they can read the EPUB.
Compared to native Confluence attachment viewing, which supports PDFs and images but cannot render EPUB content, the EPUB Reader fills a meaningful gap. Native attachment previews show a generic file icon and a download link for EPUB files, providing no way to actually read the content inline. The EPUB Reader macro transforms that experience from a dead-end download into an interactive reading session.
Which file formats does EPUB Reader for Confluence support?
The app is purpose-built for the EPUB format (files with the .epub extension). EPUB is the widely adopted open standard for digital publications, maintained by the W3C. It is the same format used by eBook retailers, digital libraries, and publishing platforms worldwide. EPUB files can contain reflowable text that adapts to different screen sizes, embedded images, styled layouts with CSS, hyperlinks, tables, and even multimedia elements in newer EPUB 3 specifications.
If your organization currently distributes content in other formats, there are a few things to consider. Confluence's native viewer already handles PDF files, Microsoft Office documents, and common image formats reasonably well. For Word documents and PDFs that you want to convert to EPUB, free and paid conversion tools are available -- Calibre is a popular open-source option that can convert from PDF, DOCX, HTML, and many other formats into EPUB. Once converted, the EPUB files can be uploaded to Confluence and read using the EPUB Reader macro.
It is worth noting that the EPUB format offers advantages over PDF for long-form reading within a browser. EPUB content is reflowable, meaning text adjusts to the width of the reader rather than being locked to a fixed page size. This makes EPUB files more comfortable to read on different screen sizes, from large desktop monitors to mobile phones, because you never need to zoom or scroll horizontally. PDF files, by contrast, have fixed layouts that can be difficult to read on smaller screens because the text does not reflow.
How do I embed an EPUB file on a Confluence page?
Embedding an EPUB on a Confluence page is a straightforward process that takes just a few clicks. The workflow is designed to be intuitive even for non-technical users, and it follows the same pattern as other Confluence macros.
First, navigate to the Confluence page where you want the EPUB to appear and click Edit to enter the page editor. In the editor, type /epub in the slash command menu, or click the + button in the toolbar and search for "EPUB Reader for Confluence." Select the macro to add it to your page. This opens the macro's configuration panel.
The configuration panel presents two options for selecting an EPUB file. If you have already attached EPUB files to the current Confluence page, they will be listed and you can simply click one to select it. If you need to add a new file, click the Upload EPUB File button to upload an EPUB directly from your computer. The uploaded file is saved as a standard Confluence attachment on the page, and it is automatically selected for display in the macro.
You also have the option to set a custom title for the reader. If you leave this field blank, the EPUB's filename will be used as the display title. If you want to show a more readable or descriptive name -- for example, "Employee Handbook 2026" instead of "employee-handbook-v3-final.epub" -- enter it in the title field.
Once you have selected a file and optionally set a title, click Save to finalize the macro. When you publish or save the page, the macro appears as a card displaying the EPUB's title and a Read button. Anyone viewing the page can click the Read button to open the full reader interface. This card-based presentation keeps pages clean and uncluttered while making the EPUB content easily accessible. For step-by-step instructions with screenshots, see the EPUB Reader for Confluence usage documentation.
Can I read EPUBs on mobile devices in Confluence?
Yes, EPUB Reader for Confluence is designed to work across devices, including mobile phones and tablets. The reader interface adapts to the available screen size, maintaining readable text and functional navigation controls even on smaller displays. This is where the reflowable nature of the EPUB format provides a significant advantage over fixed-layout formats like PDF -- text automatically adjusts to fit the screen width, so you never need to pinch-to-zoom or scroll horizontally to read a paragraph.
When you access a Confluence page containing an EPUB Reader macro from a mobile browser or the Confluence mobile app, the macro card appears just as it does on desktop. Tapping the Read button opens the reader in a full-screen view optimized for touch interaction. The navigation arrows on either side of the screen are easy to tap, and the bottom toolbar with progress tracking remains accessible without crowding the reading area.
The reading settings -- light and dark themes, and font size adjustment -- are fully functional on mobile devices. Dark mode is particularly useful for reading on phones in low-light environments, and the font size controls let you increase text size for comfortable reading without glasses or in bright outdoor conditions. Your reading progress is saved per device, so you can start reading a document on your desktop at the office and continue from where you left off on your phone during your commute.
For organizations with field teams, mobile sales staff, or remote workers who rely on phones and tablets as their primary devices, mobile EPUB reading support means that training materials, product guides, and reference documents are accessible wherever your team happens to be working.
What navigation and customization features does the reader include?
The EPUB Reader provides a comprehensive set of navigation and customization tools that make reading long-form content practical and comfortable within Confluence. These features are accessible through a clean toolbar that does not distract from the reading experience.
Table of contents navigation is available through the menu icon in the top toolbar. Clicking it opens the EPUB's structured table of contents, which displays the full chapter and section hierarchy of the document. You can jump directly to any chapter or section with a single click, which is essential for reference materials and technical manuals where readers rarely consume content sequentially from beginning to end. This is a significant advantage over native Confluence attachment viewing, which provides no way to navigate within an EPUB file at all.
Page navigation is available through multiple methods. On-screen arrow buttons (< and >) appear on the left and right sides of the reading area for clicking or tapping. Keyboard users can press the Left Arrow and Right Arrow keys to page through content. The bottom toolbar also includes dedicated Previous and Next buttons. These redundant navigation paths ensure that every user can move through the document in the way that feels most natural to them.
Reading progress tracking appears in the bottom toolbar. A visual progress bar fills as you advance through the document, and a percentage indicator shows exactly how far you have read. This gives you a clear sense of how much content remains, which is especially useful for long documents like employee handbooks or training manuals that span dozens of chapters. Your reading progress is automatically saved, so if you close the reader and return later, you can pick up exactly where you left off without needing to bookmark your position manually.
Display customization is available through the settings icon in the top toolbar. The reader offers both Light and Dark themes, which switch the background and text colors for comfortable reading in different lighting conditions. The dark theme reduces eye strain in low-light environments and is also preferred by many users during extended reading sessions. Font size adjustment lets you increase or decrease the text size to your preference, which improves readability for users with visual impairments or those reading on high-resolution displays where default font sizes may appear small.
Are there file size limits for EPUB attachments in Confluence?
The practical file size limits for EPUB files in the EPUB Reader are determined by your Confluence instance's attachment configuration rather than by the app itself. Confluence administrators can set maximum attachment sizes at the global level, and individual spaces can have their own attachment limits. These limits apply to all file types, including EPUB. For most Confluence Cloud instances, the default attachment size limit is generous enough to accommodate even lengthy EPUB files containing hundreds of pages and embedded images.
In terms of performance, the EPUB Reader handles large files well because it loads content progressively. Rather than parsing and rendering the entire EPUB at once, the reader loads content as you navigate through it. This means that opening a 50-megabyte EPUB with high-resolution images is just as responsive as opening a smaller text-heavy document. The initial load is fast, and page transitions are smooth regardless of the total file size.
For organizations with very large EPUB files -- such as illustrated technical manuals, image-heavy training materials, or compiled documentation sets -- it is worth considering whether the EPUB can be split into logical volumes. While the reader handles large files capably, splitting a 500-page manual into separate EPUB files by section or chapter can improve organization and make it easier for readers to find specific content quickly. Each volume can be embedded on its own Confluence page within a structured space hierarchy.
If you encounter issues uploading particularly large EPUB files, check with your Confluence administrator about the current attachment size limits and whether they can be increased for your use case. The EPUB Reader macro itself does not impose any additional restrictions beyond what Confluence allows for attachments.
EPUB Reader vs native Confluence attachment viewing
One of the most common questions is how EPUB Reader for Confluence compares to Confluence's built-in attachment handling. Here is a direct comparison of the two approaches for EPUB files.
| Feature | EPUB Reader for Confluence | Native Confluence Attachments |
|---|---|---|
| EPUB rendering | Full content rendering with reflowable text | File icon with download link only |
| In-page reading | Read directly on the Confluence page | Must download and open externally |
| Table of contents | Interactive chapter navigation | Not available for EPUB files |
| Progress tracking | Visual progress bar with percentage | Not available |
| Theme options | Light and dark themes | Not applicable |
| Font size control | Adjustable within the reader | Not applicable |
| Keyboard navigation | Arrow key paging | Not applicable |
| Mobile reading | Responsive reader interface | Download required on mobile |
| Saved progress | Automatically resumes where you left off | Not available |
| Custom display title | Configurable in macro settings | Shows filename |
The comparison makes it clear that native Confluence attachment handling provides essentially no reading experience for EPUB files. The EPUB Reader macro transforms EPUB from a downloadable file into a first-class content type that your team can interact with directly. For teams that regularly distribute reading materials through Confluence, this difference is the gap between "technically possible" and "actually practical."
When to use EPUB Reader for Confluence
EPUB Reader for Confluence is valuable in a wide range of scenarios. Here are common use cases where teams get the most from the app:
- Employee onboarding and handbooks. Distribute your organization's employee handbook as an EPUB on the onboarding space. New hires can read it directly in Confluence alongside onboarding checklists, team introductions, and process documentation.
- Training and certification materials. Publish training manuals, study guides, and certification preparation materials as EPUBs on dedicated training spaces. Learners can track their reading progress and return to specific chapters easily.
- Technical reference documentation. For teams that maintain long-form technical documentation, distributing it as EPUB allows readers to navigate by chapter, adjust display settings, and read comfortably on any device.
- Policy and compliance documents. Make policy documents, compliance guides, and regulatory references available as EPUBs that anyone in the organization can access and read without special software.
- Research and knowledge sharing. Teams that compile research findings, literature reviews, or annotated bibliographies can share them as EPUB files that colleagues can read and navigate efficiently.
Getting started
Setting up EPUB Reader for Confluence is quick. Your Confluence administrator installs the app from the Atlassian Marketplace. Once installed, the EPUB Reader macro is available on every page in your instance. There is no per-user configuration required -- any user with edit permission on a page can add the macro, and any user with view permission can read the embedded EPUB.
Visit the EPUB Reader for Confluence usage guide for detailed installation instructions, configuration screenshots, and a complete feature walkthrough.
Related resources
- Best Confluence apps for developers -- a curated guide to the most useful Confluence Marketplace apps for engineering teams
- FAQ: Using Confluence and Jira plugins safely -- security best practices for evaluating and managing Atlassian Marketplace apps
- EPUB Reader for Confluence documentation -- full usage guide with setup steps and feature details