Snapshots scrolling for large pages

Snapshots scrolling renders only the rows currently visible in the viewport, instead of loading the entire snapshot into the page at once. The page viewer scrolls within the snapshot rather than scrolling the Confluence page through every row.

Use it when you have very large snapshots — hundreds of rows, thousands, or in extreme cases tens of thousands — and especially when a single Confluence page has more than one large snapshot. The default behavior (load everything inline) makes the page slow to open and tedious to read.

By the end of this page, you have snapshots scrolling enabled on a specific snapshot, or you know how to ask your administrator to enable it as the site default.

When to enable it

  • A single snapshot has hundreds or thousands of rows.

  • A page contains several snapshots.

  • The page takes noticeably long to open or scroll.

  • Page viewers struggle to navigate text and other content alongside the snapshots.

If the snapshot is small (a few dozen rows), the default render is fine — there's no benefit to enabling scrolling.

1. Enable it on a single snapshot

  1. Edit the page and open the macro configuration.

  2. Go to the Layout tab.

  3. Tick Snapshot scrolling.

  4. Click Insert snapshot and republish the page.

snapshots-scrolling-config.png


Snapshot-with-snapshots-scrolling.png


You don't need to take a new snapshot when enabling or disabling this option. It only changes how the data is rendered, not what data is captured.

2. Enable it as the site default

If your site frequently produces large snapshots, an administrator can change the site-wide default so that all new snapshots are created with scrolling enabled. Existing snapshots aren't affected.

site-admin-snapshot-scrolling.jpg


What's next