Scroll Versions does not offer official support for restricting searches to specific versions (there is currently an open feature request for this, which you can vote on if you want to receive updates once this is implemented).

However, it is possible to implement a workaround by manually restricting your search by page title.

Limitations of this workaround

  • If you restrict your search to a specific version using the method explained here, the search results will only contain pages created in that specific version. If a page doesn't exist in a specific version, and the page in that version is currently a fallback to a preceding version, then it will be missing in the search results.
  • This workaround will only work with Confluence versions 5.7 and later, as earlier versions did not feature support for search filtering via CQL.

How versioned page titles work in Scroll Versions

Scroll Versions stores versioned content of a page within prefixed child pages of the master page, which is the page visible to the user. Their names are constructed as follows: .<pagetitle> v<versionname>, e.g. .Glossary v3.0

Those pages are called dot pages because of the leading dot. They are only created for a version if the content was edited in that version, which is why they are also referred to as Change pages.

Usually those pages aren't visible to users, but they can be seen within the Reorder pages dialog:

If no change page is present in a version, the content is inherited from the previous version, which is referred to as a fallback.

Restricting searches to a specific version

In this workaround, we will restrict our search results to only include results from pages with titles that include v<versionname> of the version we want to search in – so that the search is restricted to pages that exist in that specific version.

You do this by filtering your search results using the 'With title' CQL field. If you only want to search in pages created in version 1, for example, you would use the filter v1 in the 'With title' field:

... and now, the search will only feature results from pages created in version 1. If you want to change the version you are searching in, then just change the version filter accordingly.

If the search results don't include some results you think should be there, it's probably because the page you want to search in hasn't been created in the version you are searching in.