Adaptive display controls manage the Items that appear when a Member selects a dropdown in a Page selector on a Metric, Board or Widget. This article aims to explore the different adaptive display options available and how each of them operates.
Before you begin
What is adaptive display?
Adaptive display controls the Items appearing in a Page selector dropdown based on various factors, ranging from predefined available Items to dependency on other Page selections or data availability. These options can be set at the Board or Widget level.
How to access adaptive display controls
The adaptive display controls are in the Selector options panel. You can open this in the following ways:
From a Metric
Beneath the formula bar, select the slider icon with tooltip Pages options.
From a Board
Select Edit in the top right of your Board.
Beneath the Board title, select the blue slider icon with tooltip Selector options.
From a Widget
Select Edit in the top right of your Board.
Hover over your Widget, bringing up the Settings (cog) icon.
Select the Settings icon.
At the bottom of the dialog that opens, find Selectors and select Edit.
Adaptive display options
⚠️ Important
Irrespective of the Adaptive display option chosen, access rights are always respected. This means that if a Member has access rights set to
No readfor an Item, that Item does not appear in the Page selector dropdown.
All available Items
This option displays all Items that are selected in the ‘Available Items' section. If Items are excluded from that list, they do not appear in any Member’s Page selection options. Individual Members could see different options based on their access rights configurations.
Dependent Page selections
The dependent Page selections feature shows Items based on the Items chosen for the other Page selectors. For example, if you have regional and country Page selectors within a Board, selecting a regional item prompts the country Page selector to only display countries that fall within that region. Adaptive display options are set to dependent Page selections by default.
Dynamic selection
This option returns all Items for which you have some data. It takes into account both dependent Page selections and underlying data availability. If an Item does not have any data associated with it, it is not displayed. However, there are the following exceptions to this general principle:
If a Metric appearing in your View has the Show empty rows and columns option activated within the filters, this overrides the dynamic selection feature and the blank cells of Items with no underlying data are displayed. Go into the Metric and select Hide empty rows and columns to fix these blank cells.
Dynamic selection is not compatible with the following functionality applied to its Metrics:
Show Values as using the
CUMULATEandOFFSET>PREVIOUS ITEM/NEXT ITEMtools
ℹ️ Note
Of all the adaptive display options, the dependent Page selections are the best option for performance. They limit options based on parent selection while not having to check for underlying data.
Page selector options for larger lists
When implementing adaptive display options, the message Content too large to fully display may appear at the bottom of the Page selector. This message is shown when more than 1000 Items are available, limiting the dropdown to display only the first 1000 Items. However, you can search for any additional Items.
Boards and widgets
Adaptive display in Page selectors on Boards
Adaptive display options for Page selectors on Boards work similarly to those on Views. However, the main difference is that when retrieving Items to display under a rule, Pigment gathers all Items matching that rule for all widgets linked to the Page selector. This means that for an Item to appear in the Page selector dropdown, it just needs to match the adaptive display rule in at least one of the widgets linked to the Page selector.
When troubleshooting why an Item appears in a Page selector, make sure that the correct adaptive display solution is chosen, and that none of the widgets present in the Board (and to which the Page selector applies) are falling into an exception of that specific display.