The advanced plugin settings allow project admins to tweak the behaviour of Scroll Versions. This article describes what settings are available, and how to change them.
Read the documentation thoroughly before applying these changes
Generally it is not advisable to change the standard settings and you should only change them with a thorough understanding of what they do.
Please read the documentation carefully before applying any changes in production.
Change advanced settings
Some advanced plugin settings can be defined on the space level, some can be activated on the global level, and some can be activated on both. Refer to the Available settings table below to see the scope of the individual advanced settings.
- Confluence Administrators can configure settings on the global level at General Configuration > Scroll Runtime > Advanced Plugin Settings > Scroll Platform.
- Confluence Administrators and Space Administrators can configure settings on a space level at Space tools > Scroll Add-ons, and then pressing the ALT key to make a menu entry for Advanced Plugin Settings appear.
|display.getting.started.messages||3.0.7||global||for users||Uncheck the boxes to disable Scroll Versions/Translations onboarding notifications for administrators and users.|
If 'true', the page tree would remember the expanded pages when navigating to other page tree nodes (the default page tree behaviour when using Versions in a space). If set to 'false', the page tree would collapse page nodes as in space without Versions or Translations enabled.
|3.0.0||space||A JSON string that defines how versions are exposed to the Scroll Runtime, which is used to integrate Scroll Versions with other Scroll add-ons like Scroll Viewport.|
|repository.property.version.fullaccess.reviewers||3.7.0||space||true||If set to 'true', reviewers can see all versions when using Scroll Viewport. If set to 'false', they can only see versions that are marked accessible.|
global & space
|false||Every REST resource behind the URL http://<host>:<port>/<contextpath>/rest/scroll-versions/1.0/support/.... is locked by default and has to be enabled. Setting this property to true activates the support and maintenance REST resources.|
|theme-integration.json||3.0.0||global & space||unset|
|translations.restrict.to.spaces||3.0.9||global||no restrictions||A comma-separated list of space keys where the usage of Scroll Translations is allowed. An empty list means that your space admins can decide if Scroll Translations is activated in their space.|
|translations.custom.locales||3.1.0||global||no custom locales||A comma-separated list of custom locale keys to add to Scroll Translations. Keys must have the format |
This setting influences how Confluence page titles are set when publishing pages to a different space.
By default, if you have activated Scroll versions' Duplicate page titles feature, the permalink is used to set the published Confluence page title. For example, if a page's permalink is Intro Details and its Scroll page title is Introduction, then the Confluence page title (the last URL part of /dispay/spacekey/Intro+Details) of the published page in the target space will be Intro Details.
This behavior was incorrect in 3.0.0 (see - VSN-3154Getting issue details... STATUS for exact details). This bug was fixed in 3.3.2 – however, some users reported that they considered this behavior a feature. If you want, you can now switch back to the behavior to use the Scroll page title by configuring this setting to false.
This setting overrides the setting for versions.publish.global.keep.permalink.as.pagetitle for a specific space.
If the space and global settings are different, the space settings will take precedence.
If set to 'true', then when pages with workflow status 'complete' are edited, their workflow statuses are reset to the initial state. When set to false, workflow status 'complete' remains when the page is edited.
|versions.publish.flushindex||3.4.1||global||true||If set to 'false', the Confluence index queue will not be flushed by Scroll Versions when publishing a space. This will reduce the time needed for a publish job and reduces the load on your system. It might lead to content that is not available in the Confluence search index right after the publish job.|
A comma-separated list of space keys where the usage of Scroll Versions is allowed. An empty list means that your space admins can decide if Scroll Versions is activated in their space.
|3.16.0||global & space||unset||Used to control if (Excerpt) Include+ macros are highlighted in page view. Can be defined on global level and on space level with space level setting taking precedence. Additionally, any highlighting can be disabled using user-specific Scroll Settings.|