Block IP addresses in SDK

Artigo
11/22/2024

If you want Clarity to stop tracking certain IP addresses, you can add them to a blocklist. This excludes internal IPs such that related data isn't added to data gathered from your screen's visitors.

Dashboard: Site Visitors on the list don't contribute to the tracked metrics.
Recordings: No sessions from visitors on the list are recorded.
Heatmaps: Screen visitors on the list are excluded from having their activity included on taps map.

Note

Clarity only supports IPv4 addresses. We do not support IPv6 or dynamic IP addresses (for example, VPN). However, we couldn't block IP addresses if the user has both IPv4 and IPv6 as its non-deterministic.
Mobile devices generally don't have a stable IP so they can't be used for IP blocking.

Block an IP address from tracking

Note

To set up IP exclusion, you need to be an administrator for your project. If you aren't, you can see which IP addresses are blocked, but you can't change anything.

Step 1

Select a Clarity project. Go to Settings > IP blocking. Select Block IP address.

IP blocking in SDK.

Step 2

Tip

You can also block a range of IP addresses. See the next section for details.

On the pop-up screen, make your selections and select Add.

Name: Enter a friendly name to identify the IP address.
Block my current IP: Check the box to block your IP address.
IP address: Enter an IP address or multiple IP addresses separated by a ,.

Add an IP address to block in SDK.

Once you enter one or more IP addresses, each one is displayed on the IP blocking page.

List of blocked IP addresses in SDK.

Note

Wait about 15 minutes for the changes to come into effect.

Block a range of IP addresses

Follow the steps to block a range of IP addresses:

Step 1

Select a Clarity project. Go to Settings > IP blocking, and select Block IP address.

IP blocking addresses in SDK.

Step 2

On the pop-up screen, make your selections and select Add.

Name: Enter a friendly name to identify the range of IP addresses.
Block my current IP: Check the box to block your IP address.
IP address: You can use the CIDR notation <Ip-address>/<prefix-length> to denote a range of IP addresses. To define the range, append a slash after the initial address, followed by the end address. For example, specify the CIDR range 69.89.31.0/24 to block the range of IP addresses from 69.89.31.0 to 69.89.31.255.

Add a range of IP addresses to block in SDK.