OneView for Confluence

Preview every file attached to a Confluence page without leaving the page: PDFs, Office documents, images, video and more.

Confluence On the Marketplace Version 3.3.0 Updated August 27, 2026

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

  1. Insert the macro

    Edit the page, type /, search for OneView and insert it where you want the viewer. Then publish the page.

  2. Browse the files

    Use the list on the left to search by name, sort by name or size, and browse files grouped by type.

  3. Preview a file

    Click any file to open it in the viewer on the right. PDFs include page navigation, and presentations render as slides.

  4. 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.

  5. 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 .exe and .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

Version 3.3.0 August 27, 2026 Latest

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)
Version 3.2.0 August 24, 2026

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.
Version 3.1.0 August 24, 2026

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.
Version 3.0.0 August 17, 2026

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.
Version 2.6.0 August 17, 2026

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.
Version 2.3.0 July 30, 2026

Better PowerPoint previews.

  • Presentations render as real slides, including charts and SmartArt.
  • Smoother navigation between slides.
Version 2.0.0 July 23, 2026

Security and scale.

  • Larger file previews and stronger input validation throughout.
Version 1.0.0 July 19, 2026

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.