This page demonstrates how administrators and users can specify the number of attachments to process in the Attachment Table macro.
Global Configuration includes a new configuration parameter named Maximum attachments to process
Administrators can control the maximum number of attachments to process in Global Configuration for the Attachment Table macro. Setting the limit enables administrators to reduce the load and avoid Confluence performance issues. (Available since app version 8.7.0).
Log in as a user with the Confluence administrator's Global Permission.
Navigate to Manage apps > Advanced Tables for Confluence Configuration > Global Configuration
The page displays the configuration options available. For more information, refer to Configuration - 8.x.
Maximum attachments to process: Select the limit for processing the maximum number of attachments from the Maximum attachments to process drop-down. The default limit is 1000. The configuration also shows the approximate number of attachments available in the Confluence instance.
Administrators should be cautious when increasing the configuration limit, as this may lead to heavy Confluence usage and potentially result in degrading the performance of Confluence.
Limit the processing of the number of attachments in the Attachment Table macro
Users can specify the number of attachments that the macro must retrieve. The default value is the admin-configured limit for the parameter Maximum attachments to process in Global Configuration.
Select the Attachment Table macro editor.
The Page filtering tab displays the admin-configured value for the parameter Global Configuration > Maximum attachments to process and the approximate number of attachments in the instance. Specify the Page filtering selection criteria. For more information, refer to Attachment Table macro 8.x.
3. Click the Data Settings tab. The macro parameter Limit number of attachments displays the admin-configured limit for the Global Configuration parameter Maximum attachments to process.
The field description displays the admin-configured value in the Global Configuration.
4. Enter the limit for the number of attachments to retrieve in the macro parameter, Limit number of attachments to retrieve. For more information, hover over the 
icon for the help text.
The various scenarios and setting the limit for processing the number of attachments
The below scenarios illustrate how the Attachment Table macro limits the processing of the number of attachments.
Setting the Attachment Table macro limit is based on the below criteria:
The macro considers the least of the value configured between the parameters Limit number of attachments to retrieve, and Global Configuration > Maximum attachments to process to process the attachments.
The processing stops after the number of attachments found matching the Page filtering selection criteria reaches the least of the value configured. The macro displays the processed attachments and their metadata as a table.
If the macro encounters more attachments than the least value configured, the confluence page displays a warning message, or else the message is not displayed.
Scenario 1: The administrator and the user does not change the default value
Global Configuration: The administrator does not change the default value configured for the Global Configuration parameter Maximum attachments to process.
Macro browser input: The user does not change the default value for the macro parameter Limit number of attachments to retrieve.
Scenario 1 result:
The Global Configuration parameter Maximum attachments to process and the macro parameter Limit number of attachments have the default value configured as 1000. In this case, the macro considers the default value while processing the attachments.
The macro stops processing after the number of attachments found matching the Page filtering selection criteria reaches the default value of 1000. The Confluence page shows the processed attachments and their metadata as a table.
Scenario 2: The administrator changes the value for the Global Configuration parameter Maximum attachments to process.
Global Configuration: The administrator changes the default value configured for the Global Configuration parameter Maximum attachments to process.
Macro browser input: The user does not change the value for the macro parameter Limit number of attachments to retrieve.
Scenario 2 result:
In this case, the macro considers the value configured for the Global Configuration parameter Maximum attachments to process.
The macro stops processing after the number of attachments found matching the Page filtering selection criteria reaches the value configured for Maximum attachments to process. For reference, 500 attachments are shown.
The Confluence page shows the processed attachments and their metadata as a table.
Scenario 3: The user provides a higher value than the admin-configured limit
Global Configuration: The administrator has configured a limit for the Global Configuration parameter Maximum attachments to process.
Macro browser input: The user enters a higher value for the macro parameter Limit number of attachments to retrieve than the admin-configured limit in the Global Configuration.
Scenario 3 result:
In this case, the macro considers the least of the value configured between the parameters, Limit number of attachments to retrieve, and Maximum attachments to process. The macro stops processing after the number of attachments found matching the Page filtering selection criteria reaches the least of the value configured.
For example, here, the macro considers the admin-configured value for the Global Configuration parameter Maximum attachments to process that is 1000. The macro stops processing after the number of attachments found matching the selection criteria reaches the value 1000.
The Confluence page shows the processed attachments and their metadata as a table.
Scenario 4: The user provides a lower value than the admin-configured limit
Global Configuration: The administrator has configured a limit for the parameter Maximum attachments to process.
Macro browser input: The user enters a lower value for the macro parameter Limit number of attachments to retrieve than the admin-configured limit in the Global Configuration.
Scenario 4 result:
In this case, the macro considers the least of the value configured between the parameters, Limit number of attachments to retrieve, and Maximum attachments to process. The macro stops processing after the number of attachments found matching the Page filtering selection criteria reaches the least of the value configured.
For example, here, the macro considers the user-configured value for the macro parameter Limit number of attachments to retrieve that is 500. The macro stops processing after the number of attachments found matching the selection criteria reaches the value of 500.
The Confluence page shows the processed attachments and their metadata as a table.
Setting the Attachment Table macro limit for displaying the number of attachments is based on the below criteria:
The macro considers the least of the value configured between the parameters Limit number of attachments to retrieve, and Global Configuration > Maximum attachments to process to process the attachments.
The processing stops after the number of attachments found matching the Page filtering selection criteria reaches the least of the value configured. The macro displays the processed attachments and their metadata as a table.
If the macro encounters more attachments than the least value configured, the confluence page displays a warning message, or else the message is not displayed.
