:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
import { HogFunctionTemplate } from '~/cdp/types'
export const template: HogFunctionTemplate = {
free: true,
status: 'stable',
type: 'transformation',
id: 'template-user-agent',
name: 'User Agent Populator',
description:
'Reads the user agent from the event and sets $browser, $browser_version, $os, $device and $device_type from it.',
icon_url: 'https://res.cloudinary.com/dmukukwp6/image/upload/q_auto,f_auto/builder_hog_01_955c082cad.png',
category: ['Custom'],
code_language: 'hog',
code: `
if (empty(event.properties)) {
return event
}
// $raw_user_agent is what capture and the Vercel source set. Read it after the aliases so an
// explicitly populated one still wins. Take the first candidate that holds a user agent rather
// than the first non-null one, so an empty alias does not hide a populated one behind it.
let candidates := [
event.properties.$useragent,
event.properties['$user-agent'],
event.properties.$user_agent,
event.properties.segment_userAgent,
event.properties.$raw_user_agent
]
let ua := ''
for (let candidate in candidates) {
if (empty(ua) and typeof(candidate) == 'string') {
ua := candidate
}
}
if (empty(ua)) {
return event
}
let returnEvent := event
// Strip the raw user agent values now that we have read one. Done before any early return so the
// no-overwrite path also drops them. $raw_user_agent stays, because bot detection and the ad
// destinations read it after this transformation runs.
if (not empty(event.properties.$useragent)) {
returnEvent.properties.$useragent := null
}
if (not empty(event.properties['$user-agent'])) {
returnEvent.properties['$user-agent'] := null
}
if (not empty(event.properties.$user_agent)) {
returnEvent.properties.$user_agent := null
}
if (not empty(event.properties.segment_userAgent)) {
returnEvent.properties.segment_userAgent := null
}
// Do not overwrite browser or device properties the SDK already set, unless asked to.
let hasExisting := not empty(event.properties.$browser)
or not empty(event.properties.$browser_version)
or not empty(event.properties.$os)
or not empty(event.properties.$device)
or not empty(event.properties.$device_type)
if (hasExisting and not inputs.overrideExisting) {
return returnEvent
}
let parsed := parseUserAgent(ua)
if (empty(parsed)) {
return returnEvent
}
returnEvent.properties.$device := parsed.device
returnEvent.properties.$device_type := parsed.deviceType
if (not empty(parsed.browser)) {
returnEvent.properties.$browser := parsed.browser
returnEvent.properties.$browser_version := parsed.browserVersion
returnEvent.properties.$os := parsed.os
returnEvent.properties.$browser_type := parsed.browserType
}
return returnEvent
`,
inputs_schema: [
{
key: 'overrideExisting',
type: 'boolean',
label: 'Override existing properties',
description: 'Replace $browser, $os and device properties even when the event already has them.',
default: false,
required: false,
},
],
}