OneView for Confluence
Preview every file attached to a Confluence page without leaving the page: PDFs, Office documents, images, video and more.
Overview
OneView adds a macro that lists a page’s attachments and opens them in a built-in viewer. Readers can browse, search and preview files without downloading anything or switching tabs.
There’s nothing to set up: insert the macro and it works. It follows your Confluence theme, including dark mode, and only shows files the reader already has permission to open.
Features
One viewer, many formats
PDF, Word, PowerPoint, images, audio, video, Markdown, code, JSON, XML, YAML and CSV, all previewed on the page.
Organised file list
Files are grouped by type, with search and sorting to find the one you need.
Pin a key document
Page editors can pin one file so the page always opens straight to it.
Looks like Confluence
Built with Atlassian’s design language, and follows light and dark themes.
Respects permissions
Files are read with each reader’s own Confluence permissions, never more.
No tracking
OneView records nothing about who views which file.
How to use
The viewer
Wherever the macro is inserted. Type / in the editor and search for OneView
Downloads
The page’s own attachments: the paperclip in the page header, or Page options → Attachments
-
Insert the macro
Edit the page, type
/, search for OneView and insert it where you want the viewer. Then publish the page. -
Browse the files
Use the list on the left to search by name, sort by name or size, and browse files grouped by type.
-
Preview a file
Click any file to open it in the viewer on the right. PDFs include page navigation, and presentations render as slides.
-
Pin a file (optional)
Select a file and click Pin file so every reader lands on it. Click Unpin to return to the full list. Pinning needs page edit rights.
-
Download when needed
The viewer is view-only. To download a file, use the page’s attachments list.
Good to know
- Installers and archives (such as
.exeand.zip) aren’t listed, because they can’t be previewed. The file list shows how many were left out. - Spreadsheets, older Office formats (
.doc,.ppt) and templates can’t be previewed. The viewer explains why and suggests an alternative where there is one. - Click Hide files to give the preview the full width.
Privacy
- Doesn’t track readers. There’s no activity log, analytics or telemetry.
- The only thing stored is which file a macro is pinned to, kept in Atlassian Forge storage.
- Files are read with the viewer’s own Confluence permissions.
- Makes no connections outside Atlassian.
Our privacy policy covers every AryonForge app.
Release notes
Privacy first: nothing is recorded.
- Removed the activity log. OneView no longer records anything when files are opened.
- The only stored data is which file a macro is pinned to.
- Existing pages keep working with no changes needed.
Earlier versions (7)
A taller viewer and a cleaner header.
- A taller viewer, so slides and documents fit with less scrolling.
- One consistent name, OneView, in the macro picker and the viewer.
- A simpler header, and the Verify integrity button was retired.
Matches your Confluence theme.
- Supports dark mode and follows Atlassian’s design language.
- Installers and archives no longer clutter the file list.
- A “No preview” tag marks files that can’t be shown, plus accessibility improvements.
Nothing to configure.
- Removed the file policy admin page. The macro simply shows the page’s attachments.
- No new permissions and no action needed to upgrade.
View-only, with better format support.
- Downloads now happen from the page’s own attachments list.
- Fixed Excel, text and code files that previously showed an empty panel.
Better PowerPoint previews.
- Presentations render as real slides, including charts and SmartArt.
- Smoother navigation between slides.
Security and scale.
- Larger file previews and stronger input validation throughout.
Initial release.
- Inline previews for PDF, images, audio, video, Markdown, code, structured data and CSV.
- File search, sorting and pinning.
Questions about OneView for Confluence?
Open a request in our support portal or email support@aryonforge.com. We reply within one business day, Monday to Friday.