Configure the limit for User Options results

Configure the limit for User Options results

Overview

From version 8.24.0 onwards, Scaffolding provides an administrator setting that allows Confluence administrators to set the default limit for User Options results. The processing stops when this limit is exceeded, and an error message is displayed.

 

Understand the limitations of User Options

The User Options macro is useful for retrieving users with specific permissions from various user directories. However, when the type parameter of the parent List Data is set to check or select, processing many users with their permissions may cause performance issues for Confluence.

If there are many user results, selecting an option from a long list of radio buttons, checkboxes, or dropdown menus can be tedious. In that use case, setting the type parameter of the parent List Data to Auto Complete is more appropriate.

This limit targets accidental misuse of the powerful User Options macro at an upstream stage when very large user directories are being queried.

This limit is different from the List Data items limit. The List Data items limit activates downstream just before rendering and targets all List Data sub-macros.

Configure the User Options limit

When upgrading to Scaffolding 8.24.0, this query limit is enabled by default, and the default limit value is 250.

  1. Select Administration ( ) > Manage apps.

  2. Go to SCAFFOLDING CONFIGURATION in the sidebar and click Settings.

  3. In the User Options query limit settings section, click Edit.

    Image contains the settings for the User Options query limit.
  4. Use the Enabled toggle to enable or disable the User Options limit setting.

    User Options query limit settings
  5. In the User Options query limit field, update the value to set a new limit.

  6. Click Save.

From version 8.24.0 onwards, the processing stops when this limit is exceeded and an error message is displayed.