docs(web-trackers): document preserveOriginalReferrer tracker option - #1873
Merged
Matus Tomlein (matus-tomlein) merged 2 commits intoJul 27, 2026
Merged
Conversation
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
documentation | 6717999 | Commit Preview URL Branch Preview URL |
Jul 27 2026, 02:00 PM |
|
Thanks for your pull request. Is this your first contribution to a Snowplow open source project? Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA). 📝 Please visit https://docs.snowplowanalytics.com/docs/contributing/contributor-license-agreement/ to learn more and sign. Once you've signed, please reply here (e.g. I signed it!) and we'll verify. Thanks. |
Matus Tomlein (matus-tomlein)
approved these changes
Jul 27, 2026
Matus Tomlein (matus-tomlein)
marked this pull request as ready for review
July 27, 2026 13:56
Matus Tomlein (matus-tomlein)
deleted the
loop/3a607af295a280da8c2adea3051ca267-documentation
branch
July 27, 2026 13:56
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Documents the new
preserveOriginalReferrertracker option added tobrowser-tracker-core. Three files updated:tracker-setup/initialization-options/index.mdpreserveOriginalReferrerrow to the initialization options table, positioned afterpreservePageViewIdForUrl(samepreserve*family), with defaultfalse, typeboolean, and a link to the new anchor.preserveOriginalReferrer: falseto both the JS-tag and Browser-npm code examples so the option is discoverable at the point of setup.tracking-events/page-views/index.md### Preserve the original referrer in SPAssubsection under the existing 'Change ID behavior for SPAs' section.document.referrer(direct navigation), and includes code examples for both tracker variants.tracking-events/index.mdpreserveOriginalReferrer: true(recommended for most integrations) and the existing imperativesetReferrerUrl(document.referrer)(retained for cases needing more control). All existing content preserved.Reviewer checklist
initialization-options/index.mdmatches thepreservePageViewIdForUrlrow.### Preserve the original referrer in SPAsheading inpage-views/index.mdfollows a</Tabs>block without a transition sentence — minor style gap noted; not blocking but worth a one-liner fix next time the section is touched.Draft PR opened for review — please verify and run CI before merging.