---
sourceDocument: Australia Field Service Management
sourceDocumentLink: https://www.servicenow.com/docs/r/australia/field-service-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Field Service Management

ft:clusterId :

    - fsm

bundleId :

    - fsm

workflow :

    - Customer and Industry


---

# Add a quick filter using an extension point

# Configure quick filters using an extension point {#ariaid-title1}

Release version: Australia  
Updated September 22, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Use script includes to add quick filters to Dispatcher Workspace.

## Before you begin

Role required: admin.  
Warning:  
You must understand JSON code to perform this procedure.

## About this task

Dispatcher Workspace provides five quick filter criteria. To filter on a field that isn't included by default, create a script include, then add it as a new implementation so it appears as a selectable
filter.

Which table the Skill criterion reads from depends on the com.snc.skills_management.wm_task_migrate_skills system property:

* When the property is set to true, the criterion evaluates the Task Skills (task_m2m_skill) table.
* When the property is set to false, the criterion evaluates the skill field in the task table.

{#add-quick-filter__ul_skill_criterion_table}

Each criterion is an implementation of a scripted extension point, including the five shipped by default. Implementation partners can extend the same point to add criteria based on other tables related to the work order
task.

## Procedure

1. Create a new script include.
2. Make additions or update the script include:  
   * Object.extendsObject(DispatcherWorkspaceQuickFilterExtensionPoint, { ... })
   * Scope: sn_fsm_disp_wrkspc
   * Implement all required methods: isActive, getFilterType, getFilterId, getDisplayName, getFilterOptions, getOperators, getOperatorGroups, getFilterData, applyQueryCondition, matchesBatch, getOperatorExecutionModes, buildCondition
   * getFilterType() returns "task"
   * getFilterId() returns a stable unique string key
   * getOperatorGroups() uses groupId: 'positive' / groupId: 'negative'
   * Use GlideRecordSecure (not GlideRecord)
   * Guard empty searchString, empty selectedValues, empty taskSysIds
   {#add-quick-filter__ul_script_include_additions}
3. Add the script include as a new implementation of the extension point:  
   * point: sn_fsm_disp_wrkspc.DispatcherWorkspaceQuickFilterExtensionPoint
   * script_include: sys_id of the Script Include above
   * active: true
   * sys_scope: sn_fsm_disp_wrkspc
   * order: unique value (existing ones use 100, 300 --- pick next)
   {#add-quick-filter__ul_extension_instance_fields}