---
sourceDocument: Brazil Customer Service Management
sourceDocumentLink: https://www.servicenow.com/docs/r/customer-service-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Customer Service Management

ft:clusterId :

    - csm

bundleId :

    - csm

workflow :

    - Customer and Industry


---

# CSM Query Rules

# CSM Query Rules {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Query rules are used to filter the records in CSM related tables that are accessible by users with CSM roles. These filters, which are applied in query business rules and READ ACLs on CSM related tables, are stored in a metadata table.
Starting with the London release, query rules and filters were defined in the CSQueryBRUtilOOBConstants script include. In the Quebec release, these filters have been moved to the Query Rule (sn_query_rule) table.

This change applies to Query business rules (QBRs) and read ACLs on CSM related tables. Each data table that used QBRs before Quebec now has a new QBR that uses the new logic. Tables with read ACLs that used filters from the CSQueryBRUtilOOBConstants script include now
have one more read ACL that uses the filters from the Query Rule table.

As a user with the sn_queryrules.admin role, you can create, update, view and delete a query rule. As a user with the role, you can view the query rules table.

## Availability {#csm-query-rules__section_n1f_bd1_mnb}

The CSM query filters feature is active on zBoot instances. Existing customers must contact ServiceNow Customer Support to enable this feature.

## Query rules property {#csm-query-rules__section_ywk_2c1_mnb}

The sn_cs_queryrules.use_query_rules property determines whether to use the Query Rule table or the CSQueryBRUtilOOBConstants script include. This property is set to true for zBoot instances and false for upgraded instances.

* If true, the instance uses rules and filters from the Query Rule table to determine read access to the CSM tables for the logged-in user.
* If false, the instance uses rules and filters from the CSQueryBRUtilOOBConstants and its extensions to determine read access to the CSM tables for the logged-in user.
{#csm-query-rules__ul_r3f_ld1_mnb}

## Query Rule table {#csm-query-rules__section_eqk_4d1_mnb}

The Query Rule (sn_query_rule) table extends the sys_metadata table and stores filters for the following tables:

* Case (sn_customerservice_case)
* Affected Install Bases (sn_install_base_m2m_affected_install_base)
* Install Base Items (sn_install_base_item)
* Installed Products (sn_install_base_m2m_installed_product)
* Sold Products (sn_install_base_sold_product)
* Order Case (csm_order_case)
* Sold Product Covered (sn_install_base_m2m_contract_sold_product)
* Orders (csm_order)
* Asset (alm_asset)
* Entitlement (service_entitlement)
* Account (customer_account)
* Work Order (wm_order)
* Contact (customer_contact)
* Contract (ast_contract)
{#csm-query-rules__ul_yrt_qd1_mnb}
**Related reference**   

* [Granular roles and entities for responsibility framework](https://www.servicenow.com/docs/gII0LVwd_V274Ngnw3DtvQ "Starting with the Yokohama release, module-level granular roles simplify defining and configuring the responsibility framework. The base system uses these roles in its table-level access control lists (ACLs) for the supported entities, so you can avoid creating custom table-level ACLs.")