pixellint

HubSpot browser pixels carry SDK fields and event context.

The inspected official SDK supplies the collector field inventory, including Hub ID a, SDK version v, client time cts and consent mask cc. Generated values and known event branches receive producer warnings; private server acceptance rules remain unavailable.

Nested identity queries retain Unicode, repeated values and literal field names. Complete HTTP captures also check the image GET transport and repeated tracking-cookie bound. The embed loader remains vendor/hubspot.

Collector fields follow the SDK source scope.

The pack accepts unknown future event labels and extra custom properties. It cannot establish configured event ownership, contact state or browser consent history from one capture.

What this pack matches

Hosts
track.hubspot.com
Paths
/__ptq.gif, /__ptbe.gif, /__ptc.gif
Vendor docs
js.hs-analytics.net/analytics/1791543000000/53.js

Rules

Codes are stable. A finding in CI, MCP, or the playground lands on the same id.

Field Required What it checks Rule ids Source
collector optional Authoritative exact path capture. Query values cannot spoof the selected endpoint. Presence diagnostic severity: warning. Evidence: vendor template. docs
a recommended SDK portalId, copied into the query. Server mandatory status is not published. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.a.missing
vendor.hubspot-pixel.param.a.empty
vendor.hubspot-pixel.param.a.invalid
docs
v recommended SDK JS_VERSION is emitted, currently 1.1. Future versions remain open. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.v.missing
vendor.hubspot-pixel.param.v.empty
docs
cts recommended SDK Date.getTime() integer milliseconds. No undocumented age window. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.cts.missing
vendor.hubspot-pixel.param.cts.empty
vendor.hubspot-pixel.param.cts.invalid
docs
cc recommended Consent category bitmask: necessary1, analytics2, advertisement4, functionality8. Presence diagnostic severity: warning. Evidence: vendor template. Minimum numeric value: 0. Maximum numeric value: 15. vendor.hubspot-pixel.param.cc.missing
vendor.hubspot-pixel.param.cc.empty
vendor.hubspot-pixel.param.cc.invalid
docs
sd optional Screen width x height, when a screen is available. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.sd.empty
vendor.hubspot-pixel.param.sd.invalid
docs
cd optional Screen colorDepth followed by -bit. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.cd.empty
vendor.hubspot-pixel.param.cd.invalid
docs
cs optional Document character set, without a closed charset list. Presence diagnostic severity: warning. Evidence: vendor template. docs
ln optional Lowercased navigator.language or browserLanguage, without an ISO-only restriction. Presence diagnostic severity: warning. Evidence: vendor template. docs
bfp optional Consented browser fingerprint, omitted when unavailable. Algorithm and runtime state remain opaque. Presence diagnostic severity: warning. Evidence: vendor template. docs
pt optional SDK privacy mode OPT_IN/hideDecline0, OPT_IN1, NO_COOKIES2, COOKIES_BY_CATEGORY3. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.pt.empty
vendor.hubspot-pixel.param.pt.invalid
docs
ce optional Cookie tracking disabled flag, emitted false when consent is unavailable. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.ce.empty
vendor.hubspot-pixel.param.ce.invalid
docs
nc optional utk.isNew() Boolean, when a visitor token exists. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.nc.empty
vendor.hubspot-pixel.param.nc.invalid
docs
rv optional Reset visitor marker, currently emitted as1. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.rv.empty
vendor.hubspot-pixel.param.rv.invalid
docs
qo optional Whether the original path was enriched by initial URL parameters. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.qo.empty
vendor.hubspot-pixel.param.qo.invalid
docs
rqo optional Whether referrer was enriched by initial referrer parameters. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.rqo.empty
vendor.hubspot-pixel.param.rqo.invalid
docs
puqo optional Whether page URL was enriched by initial URL parameters. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.puqo.empty
vendor.hubspot-pixel.param.puqo.invalid
docs
icv optional Page metadata inChatView. The SDK copies caller data without enforcing a type. Presence diagnostic severity: warning. Evidence: vendor template. docs
i optional Inner hstc.utils.param identity query. Custom keys and repeated arrays remain literal. Presence diagnostic severity: warning. Evidence: vendor template. docs
tc optional Up to five targeted-content triples, emitted as repeated query strings. Tuple identifiers may contain hyphens. Presence diagnostic severity: warning. Evidence: vendor template. docs
k recommended Integer event kind on the general tracking route. Known branches are constrained; future numbers stay open. Applies when {"kind":"value_in","param":"collector","values":["__ptq"]}. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.k.missing
vendor.hubspot-pixel.param.k.empty
vendor.hubspot-pixel.param.k.invalid
docs
n recommended JS custom-event internal name pe{HubID}_{name}, mapped directly to wire n. Applies when {"kind":"value_in","param":"collector","values":["__ptbe"]}. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.n.missing
vendor.hubspot-pixel.param.n.empty
vendor.hubspot-pixel.param.n.invalid
docs
fi recommended Form activity always emits safeString(formId), which can be empty. Applies when {"kind":"value_in","param":"k","values":["15","16","17","18","19"]}. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.fi.missing docs
st recommended Feedback event always emits safeString(surveyType), which can be empty. Applies when {"kind":"value_in","param":"k","values":["26"]}. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.st.missing docs
si recommended Feedback event always emits safeString(surveyId), which can be empty. Applies when {"kind":"value_in","param":"k","values":["26"]}. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.si.missing docs
aij recommended CTA event builds a JSON two-string tuple. It does not escape arbitrary caller quotation marks. Applies when {"kind":"value_in","param":"k","values":["12"]}. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.aij.missing docs
rfc recommended Published CTA branch emits rfc8. Applies when {"kind":"value_in","param":"k","values":["12"]}. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.rfc.missing
vendor.hubspot-pixel.param.rfc.empty
vendor.hubspot-pixel.param.rfc.invalid
docs
ad optional Audio duration is copied only for native JS number input. The SDK also emits NaN/Infinity; service semantics are unpublished. Applies when {"kind":"value_in","param":"k","values":["33"]}. Presence diagnostic severity: warning. Evidence: vendor template. vendor.hubspot-pixel.param.ad.empty
vendor.hubspot-pixel.param.ad.invalid
docs
pi optional SDK copies pageId; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
ct optional SDK copies contentType; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
ccu optional SDK copies canonicalUrl; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
po optional SDK copies path, possibly enriched with initial parameters; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
opo optional SDK copies original path before enrichment; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
rpo optional SDK copies referrerPath; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
rcu optional SDK copies relCanonicalUrl when explicit canonicalUrl is absent; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
cpi optional SDK copies contentMetadata.contentPageId; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
cgi optional SDK copies contentMetadata.contentGroupId; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
cfi optional SDK copies contentMetadata.contentFolderId; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
lpi optional SDK copies contentMetadata.legacyPageId; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
abi optional SDK copies contentMetadata.abTestId; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
lvi optional SDK copies contentMetadata.languageVariantId; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
lvc optional SDK copies contentMetadata.languageCode; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
mabci optional SDK copies mabData.correlationId, emitted together with experimentId; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
mabei optional SDK copies mabData.experimentId, emitted together with correlationId; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
scpct optional SDK copies contentMetadata.scpContentType; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
r optional SDK copies resolved document referrer; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
orf optional SDK copies original referrer before enrichment; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
pu optional SDK copies resolved page URL; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
opu optional SDK copies original page URL; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
t optional SDK copies document title; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
vi optional SDK copies visitor token from current runtime; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
u optional SDK copies hubspotutk cookie value; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
b optional SDK copies __hssc session cookie value; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
fci optional SDK copies form conversion ID; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
fvi optional SDK copies form variant ID; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
lfi optional SDK copies lead-flow ID; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
ft optional SDK copies form type, including0; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
afi optional SDK copies audio file ID; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
aei optional SDK copies audio episode ID; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
asi optional SDK copies audio show ID; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
amt optional SDK copies audio module type; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
aps optional SDK copies audio play-session ID; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
aep optional SDK copies audio event phase; no unpublished business-value grammar is inferred. Presence diagnostic severity: warning. Evidence: vendor template. docs
custom_properties… optional Custom-event/click properties are prefixed with _. Native arrays emit repeated fields; other JS values use URI string coercion. Presence diagnostic severity: warning. Evidence: vendor template. docs
https recommended The published browser SDK constructs HTTPS collector URLs. Evidence: vendor template. vendor.hubspot-pixel.https docs
mab_experiment recommended The SDK emits MAB correlation and experiment IDs together. vendor.hubspot-pixel.mab_experiment docs
mab_correlation recommended The SDK emits MAB experiment and correlation IDs together. vendor.hubspot-pixel.mab_correlation docs
tc_max_occurrences recommended Published HubSpot SDK build 1.4506 emits at most five targeted-content tc values. Additional values exceed the producer bound; backend acceptance is not established. Evidence: vendor template. vendor.hubspot-pixel.tc_max_occurrences docs
root optional Identity query becomes a native object. Decoded body source: i. Encoding: query_params_json. Inner form query decoding turns plus into spaces and preserves repeated literal names as arrays. Decoding diagnostic severity: warning. Presence diagnostic severity: warning. Evidence: vendor template. Native JSON type: object. vendor.hubspot-pixel.body.root.invalid docs
email optional Email may be scalar or repeated query values; request transport does not prove server multiplicity semantics. Decoded body source: i. Encoding: query_params_json. Inner form query decoding turns plus into spaces and preserves repeated literal names as arrays. Decoding diagnostic severity: warning. Presence diagnostic severity: warning. Evidence: vendor template. Native JSON type: string or array. vendor.hubspot-pixel.body.email.invalid docs
email optional Basic email-shape advisory, not the unavailable complete HubSpot validator grammar. Decoded body source: i. Encoding: query_params_json. Inner form query decoding turns plus into spaces and preserves repeated literal names as arrays. Decoding diagnostic severity: warning. Applies when {"kind":"json_type","param":"email","json_type":"string"}. Presence diagnostic severity: warning. Evidence: heuristic. vendor.hubspot-pixel.body.email.empty
vendor.hubspot-pixel.body.email.invalid
docs
root optional Basic email shape for each repeated string, while preserving all occurrences. Body scope: email[]. Decoded body source: i. Encoding: query_params_json. Inner form query decoding turns plus into spaces and preserves repeated literal names as arrays. Decoding diagnostic severity: warning. Presence diagnostic severity: warning. Evidence: heuristic. Native JSON type: string. vendor.hubspot-pixel.body.root.empty
vendor.hubspot-pixel.body.root.invalid
docs
root optional SDK CTA tuple contains exactly two entries. Decoded body source: aij. Encoding: json. Decoding diagnostic severity: warning. Applies when {"kind":"value_in","param":"k","values":["12"]}. Presence diagnostic severity: warning. Evidence: vendor template. Native JSON type: array. Minimum array items: 2. Maximum array items: 2. vendor.hubspot-pixel.body.root.invalid docs
root optional Each CTA tuple entry is quoted as a JSON string by the SDK. Body scope: []. Decoded body source: aij. Encoding: json. Decoding diagnostic severity: warning. Applies when {"kind":"value_in","param":"k","values":["12"]}. Presence diagnostic severity: warning. Evidence: vendor template. Native JSON type: string. vendor.hubspot-pixel.body.root.invalid docs
method optional SDK loads each request through new Image(1,1).src, which issues GET. Complete HTTP capture contract. Presence diagnostic severity: warning. Evidence: vendor template. Native JSON type: string. vendor.hubspot-pixel.http.method.empty
vendor.hubspot-pixel.http.method.invalid
docs
body_encoding optional The published image producer sends no request entity. Complete HTTP capture contract. Presence diagnostic severity: warning. Evidence: vendor template. Native JSON type: string. vendor.hubspot-pixel.http.body_encoding.empty
vendor.hubspot-pixel.http.body_encoding.invalid
docs
query.tc optional SDK emits at most five targeted-content entries. Native query arrays preserve repeated occurrences. Complete HTTP capture contract. Presence diagnostic severity: warning. Evidence: vendor template. Native JSON type: string or array. Maximum array items: 5. vendor.hubspot-pixel.http.query.tc.invalid docs

Validate a payload

pixellint validate url "$ARTIFACT" --rulepack vendor/hubspot-pixel

Try this failing payload in the playground. HubSpot tracking pixel missing Hub ID.

https://track.hubspot.com/__ptq.gif?k=1

cargo install pixellint · npm install pixellint