URL Normalization

URL Normalization

Normalizes URLs by replacing dynamic path segments (containing numbers or capital letters) with :id placeholders. This helps group similar URLs together for analysis.

Configuration

OptionDescription
Remove hash parameter
Type: boolean
Required: False

Whether to remove the hash parameter in the normalized URL

Remove query string
Type: boolean
Required: False

Whether to remove the query string in the normalized URL

Replace with token
Type: string
Required: False

The string to replace parts that look like a dynamic path segment. Defaults to :id

URL properties to normalize
Type: string
Required: True

Comma-separated list of event properties to normalize. Can include both event properties and top-level event fields like distinct_id.

Regex
Type: string
Required: False

The regex to use to match the dynamic path segment. The default value will match UUIDs and strings of 3 or more capital letters or numbers.

Using our REST API you can create this transformation like so:

Terminal