---
title: Filter by IP Mapping
description: "## Filter by IP Mapping IP Mapping is the action of **assigning **a **custom name to an IP Address.** This is a filter that can be created by **assigning**a **custom name**(text) to an **IP address.** - **Device private. IP v4 mapping**…"
url: "https://gatlabs.com/knowledge/tech-tips/filter-by-ip-mapping/"
updated: "2025-07-16"
category: URL Filtering
tags:
  - GAT Shield
---

# Filter by IP Mapping

## Filter by IP Mapping

IP Mapping is the action of **assigning **a **custom name to an IP Address.**

This is a filter that can be created by **assigning**a **custom name**(text) to an **IP address.**

- **Device private. IP v4 mapping**
- **Device public. IP v4 mapping**

It can be used to filter IP address data by searching for the custom name instead of the IP address itself.

### Create IP Mapping

Navigate to **Shield > Configuration > IP Addresses > Mapping **

![On the left side menu select configuration then scroll donw to ip addresses then mapping - in the mapping window click on the New mapping button on the left side](https://gatlabs.com/knowledge/wp-content/uploads/2021/11/2025-07-16-14_38_30-Shield.png)

This will allow you to set up IP Mapping.

Click on **+ New mapping,**and a pop-up menu will be displayed. Fill in the details.

- ****IPs -****Define public and/or private IPv4. Entered addresses will be used to modify device data presented in the Geo Reporting section.CIDR notation is optional.
- **Public and Private IP addresses** - Specify Public IPv4 and/or Private IPv4    
- **Location** - If public and private IPs match with device IPs, then location details will be overridden.  
  - **Coordinates latitude**- set default latitude
  - **Coordinates longitude** - set default longitude
  - **City name** - set default City name

![A pop-up window titled "New Mapping" is displayed. It includes fields for a mapping name, public IP address, private IP address, latitude, longitude, and city name, with corresponding placeholders. A "Create" button is at the bottom.](https://gatlabs.com/knowledge/wp-content/uploads/2021/11/2025-07-16-14_46_29-Shield.png)

### Result

When clicking on **Save,**the IP Mapping will be saved to the list.

Under the **Action** tab, the IP Mapping can be **edited** (pen icon) or **deleted** (x icon).

![in the IP mapping the saved mappings will be displayed, hoovering over it will show 3 additional buttons on the right side, button to delete, update, disable or details](https://gatlabs.com/knowledge/wp-content/uploads/2021/11/2025-07-16-15_17_22-Shield.png)

### Filter by IP Mapping

In the Shield console, you can run a search by the **IP Mapping filters that we just created.**

For example:

Search for the browsing filtered by the Mapped IP.

- **Device private. IP v4 mapping**
- **Device public. IP v4 mapping**

On the top right corner you can filter by time frame.

![For example in the browisng section on the left menu when click on browsing under Audit - you can filter by Device priavete IP mapping and device public iP mapping](https://gatlabs.com/knowledge/wp-content/uploads/2021/11/2025-07-16-15_24_27-Shield.png)

The filters above are available in every section under **Audit** in the**Shield console.**

Those filters can be used to filter IP addresses.

Instead of manually entering the IP address, the IP-mapped **custom name** can be used.