---
sourceDocument: Australia ServiceNow AI Platform user interface
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/platform-user-interface

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia ServiceNow AI Platform user interface

ft:clusterId :

    - platux

bundleId :

    - platux

workflow :

    - Platform


---

# Create a dynamic filter option

# Create a dynamic filter option {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Dynamic filter options enhance filtering by allowing users to run existing script
includes or JavaScript against a reference field within condition builders and dynamic
reference qualifiers.

## Before you begin

Role required: admin

## About this task

This task describes how to create a new dynamic filter option and an associated [script include](https://www.servicenow.com/docs/access?context=c_ScriptIncludes&version=australia&pubname=australia-api-reference&ft:locale=en-US).

Dynamic filter options "objectize" script includes/JavaScript, enabling them to be
reused in multiple [condition builders](https://servicenow-prod.fluidtopics.net/IIN4hZqrIKyLkjH1bZU7hA "A condition builder constructs a condition statement with a series of contextually generated fields. Condition builders are used in many operations, such as creating filters, administering surveys, and administering access control.") and dynamic [Reference qualifiers](https://www.servicenow.com/docs/access?context=c_ReferenceQualifiers&version=australia&pubname=australia-platform-administration&ft:locale=en-US). This type of filter enables you to modify a script
once and have the changes automatically take effect everywhere the dynamic filter
option is used.  
When defining a dynamic filter, you can:

* use an existing is (dynamic) dynamic filter option (condition builder only)
* use an existing dynamic filter option (OOB or custom)
* create a new dynamic filter option and script include/JavaScript
{#t_DynamicFilterOptions__ul_o3z_zhh_xdb}  
All condition builder dynamic filters use the is (dynamic) operator and call a dynamic filter option. In the following example, the pre-existing dynamic filter option Me is being used. For a list of available pre-existing condition builder dynamic filter options, see [Dynamic operators](https://servicenow-prod.fluidtopics.net/l~PZi~3MdlD9yfs6FDggAQ "The dynamic operator, is (dynamic), lists predefined dynamic filter options where the condition value is computed from a value in a reference field.").  
Note:  
Dynamic filters are supported in scoped applications, but they are not supported in UI policy conditions.
Figure 1. Dynamic operands

## Procedure

1. [Create a scripted filter](https://www.servicenow.com/docs/access?context=c_ScriptIncludes&version=australia&pubname=australia-api-reference&ft:locale=en-US) as a client-callable script include or business rule.
2. Navigate to System DefinitionDynamic Filter Options.
3. Select New.
4. Complete the form.  
   {#t_DynamicFilterOptions__table_sjh_ptk_gp__entry__2}

   | Field | Description |
   |-|-|
   | Label | Enter a descriptive name for the dynamic filter option. |
   | Script | Enter the name of the function you created, JavaScript (no script include needed), or the complete script include/business rule call, such as `new GlobalCanvasUtil().refQualPaTabs()`. |
   | Field type | Select Reference. |
   | Referenced table | Select the table to which this dynamic filter option applies. |
   | Order | Enter a number to designate the placement of this dynamic filter option in the filter option choice list. |
   | Roles | Select the role a user must have to see this option. |
   | Active | Enable or disable the option. |
   | Reference script | Optional. Select the client-callable script include or business rule you created for the scripted filter. If the Script field contains JavaScript, an encoded query, or the entire script include/business rule reference, this field can be empty. |
   | Available for filter | Select this option to display the dynamic filter option as a filter breadcrumb. |
   | Available for default | Select this option to allow dynamic filter option to be a default in a dictionary entry. |
   | Available for ref qual | Select this option to allow dynamic filter option to be selected as a dynamic reference qualifier. |
   [Table 1. Dynamic filter options]

   {#t_DynamicFilterOptions__table_sjh_ptk_gp}  
   Note:  
   Dynamic filters using Table API GET methods in scripts only work when using the same user configured in the basic authentication profile. To allow multiple users access to the dynamic filters, use global JavaScript APIs such as GlideRecord and GlideQuery APIs instead.
5. Select Submit.
**Related tasks**   

* [Create and edit filters](https://servicenow-prod.fluidtopics.net/mIPl4~wh84X0eEsDHHAJCA "Set up and edit an admin-configured filter.")
* [Delete filters](https://servicenow-prod.fluidtopics.net/adoJ1jnuiyEGaX9Og6kRkQ "You can delete any saved filter, including global, group, or personal filters.")
* [Create scripted filters](https://servicenow-prod.fluidtopics.net/2jU3eOxSwsfCdbzBhepy8w "The condition builder alone cannot create some filters, such as displaying a record set that depends on an unrelated table. If you know JavaScript, you can create JavaScript functions for use in advanced filters.")

*[\>]: and then