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
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.missingvendor.hubspot-pixel.param.a.emptyvendor.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.missingvendor.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.missingvendor.hubspot-pixel.param.cts.emptyvendor.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.missingvendor.hubspot-pixel.param.cc.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.missingvendor.hubspot-pixel.param.k.emptyvendor.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.missingvendor.hubspot-pixel.param.n.emptyvendor.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.missingvendor.hubspot-pixel.param.rfc.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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.emptyvendor.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