Use Location Filter criteria
Use location filter criteria in the authentication policy and restrict access to the users based on the location.
Before you begin
Role required: adaptive_auth_admin
Plugin required: Zero Trust - Location Based Access (com.snc.zero_trust_location_access).
Property: The Adaptive authentication property must be enabled.
Note: Administrators can only create the policy based on location filters if the location is available for the current user session.
The following procedure describes how to create and use the location filter criteria in an authentication policy.
Procedure
-
Navigate to All > Adaptive Authentication > Filter Criteria > Location Filter.
-
Select New.
-
On the form, fill in these fields.
Field Description Name Name to identify the criteria. Description Short description of the criteria. Application Scope of the application. -
In the Locations sections, under the Locations for criteria tab, double-click (or use the keyboard shortcut) to Insert a new row.
-
Specify the locations.
For example, use some of the APAC regions to control the logins of the users coming from APAC.
[Omitted image "apac-filter-criteria.png"] Alt text: Filter Criteria
Based on the criteria set in the example, you can control logins from
Indonesia,China, andMalaysiafor your instance. -
Select Submit.
-
Use the filter criteria created in any of the authentication contexts (Pre, Post, MFA) and Session Access.
To learn more about the configuration based on authentication context and session access, see:
- Location Filter in Pre Authentication Context
- Location Filter in Post Authentication Context
- Location Filter in MFA Context
- Location Filter for Session Access
You can use the Property ID - Error message to be displayed to the user when login fails due to authentication policy failure (
glide.auth.policy.ui.error.message) to customize the error message.
---
title: Use Location Filter criteria
description: Use location filter criteria in the authentication policy and restrict access to the users based on the location.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/platform-security/authentication/use-location-filter-criteria.html
release: australia
product: Authentication
classification: authentication
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Location filter, Filter criteria, Adaptive authentication, Authentication, Access Management]
---
# Use Location Filter criteria
Use location filter criteria in the authentication policy and restrict access to the users based on the location.
## Before you begin
Role required: adaptive\_auth\_admin
Plugin required: **Zero Trust - Location Based Access** \(`com.snc.zero_trust_location_access`\).
Property: The Adaptive authentication property must be enabled.
**Note:** Administrators can only create the policy based on location filters if the location is available for the current user session.
The following procedure describes how to create and use the location filter criteria in an authentication policy.
## Procedure
1. Navigate to **All** > **Adaptive Authentication** > **Filter Criteria** > **Location Filter**.
2. Select **New**.
3. On the form, fill in these fields.
|Field|Description|
|-----|-----------|
|Name|Name to identify the criteria.|
|Description|Short description of the criteria.|
|Application|Scope of the application.|
4. In the **Locations** sections, under the Locations for criteria tab, double-click \(or use the keyboard shortcut\) to **Insert a new row**.
5. Specify the locations.
For example, use some of the APAC regions to control the logins of the users coming from APAC.
\[Omitted image "apac-filter-criteria.png"\] Alt text: Filter Criteria
Based on the criteria set in the example, you can control logins from `Indonesia`, `China`, and `Malaysia` for your instance.
6. Select **Submit**.
7. Use the filter criteria created in any of the authentication contexts \(Pre, Post, MFA\) and Session Access.
To learn more about the configuration based on authentication context and session access, see:
- [Location Filter in Pre Authentication Context](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-security/authentication/use-lf-pre-auth.md)
- [Location Filter in Post Authentication Context](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-security/authentication/use-lf-post-auth.md)
- [Location Filter in MFA Context](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-security/authentication/use-lf-in-mfa.md)
- [Location Filter for Session Access](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-security/authentication/lf-for-session-access.md)
You can use the Property ID - Error message to be displayed to the user when login fails due to authentication policy failure \(`glide.auth.policy.ui.error.message`\) to customize the error message.
| title | Use Location Filter criteria |
| description | Use location filter criteria in the authentication policy and restrict access to the users based on the location. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/platform-security/authentication/use-location-filter-criteria.html |
| release | australia |
| product | Authentication |
| classification | authentication |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 1 |
| breadcrumb | Location filterFilter criteriaAdaptive authenticationAuthenticationAccess Management |