# FilterPageHandler attribute
> Version: _Available or changed with runtime version 1.0._
Specifies that the method is a FilterPageHandler method, which handles a specific filter page. The FilterPageHandler tests the UI that is generated by a FilterPageBuilder Data Type.
## Applies to
 Method
> NOTE
> The FilterPageHandler attribute can only be set inside codeunits with the SubType property set to Test.
## Syntax
> Version: _Available or changed with runtime version 1.0._
```al
[FilterPageHandler]
procedure FilterPageHandler(var Record1: RecordRef [; var Record2: RecordRef] [; var Record3: RecordRef] [; var Record4: RecordRef] [; var Record5: RecordRef] [; var Record6: RecordRef] [; var Record7: RecordRef] [; var Record8: RecordRef] [; var Record9: RecordRef] [; var Record10: RecordRef]) : Boolean;
```
> IMPORTANT
> The above signature requires the FilterPageHandler method to be global. See https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-al-methods.md%23local-and-global-scope.
### Arguments
Record1
Type: ../methods-auto/recordref/recordref-data-type
Holds the record of the filter page.
*[Optional] Record10*
Type: ../methods-auto/recordref/recordref-data-type
Holds the record of the filter page.
*[Optional] Record2*
Type: ../methods-auto/recordref/recordref-data-type
Holds the record of the filter page.
*[Optional] Record3*
Type: ../methods-auto/recordref/recordref-data-type
Holds the record of the filter page.
*[Optional] Record4*
Type: ../methods-auto/recordref/recordref-data-type
Holds the record of the filter page.
*[Optional] Record5*
Type: ../methods-auto/recordref/recordref-data-type
Holds the record of the filter page.
*[Optional] Record6*
Type: ../methods-auto/recordref/recordref-data-type
Holds the record of the filter page.
*[Optional] Record7*
Type: ../methods-auto/recordref/recordref-data-type
Holds the record of the filter page.
*[Optional] Record8*
Type: ../methods-auto/recordref/recordref-data-type
Holds the record of the filter page.
*[Optional] Record9*
Type: ../methods-auto/recordref/recordref-data-type
Holds the record of the filter page.
## Remarks
The FilterPageHandler method is called when a filter page is invoked in the code. It tests the UI that is generated by a FilterPageBuilder data type.
You use handler methods to automate tests by handling instances when user interaction is required by the code that is being tested by the test method. In these instances, the handler method is run instead of the requested user interface. The handler method should simulate the user interaction for the test case, such as validating messages, making selections, or entering values. You declare a handler type attribute on the method. Learn more about handler methods in Create Handler Methods<../devenv-creating-handler-methods>.
## Related information
AL Method Reference<../methods-auto/library>
devenv-method-attributes
Test Codeunits and Test Functions<../devenv-test-codeunits-and-test-methods>

Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/attributes/devenv-filterpagehandler-attribute, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact. https://jonas-paprotka.de/docs/dev-itpro/developer/attributes/devenv-filterpagehandler-attribute/
