Skip to content

Update pricing url with ref and refAction params [GRO-282]#24339

Merged
akristen merged 6 commits intodocker:mainfrom
tiaramj:tiara/gro-282
Mar 12, 2026
Merged

Update pricing url with ref and refAction params [GRO-282]#24339
akristen merged 6 commits intodocker:mainfrom
tiaramj:tiara/gro-282

Conversation

@tiaramj
Copy link
Contributor

@tiaramj tiaramj commented Mar 11, 2026

Description

In order to better attribute upgrade sources, we are adding two params - ref and refAction to the existing pricing url.
The ref will be "Docs" and the refAction will be the particular docs page from where the pricing url click is originated.

Related issues or tickets

https://docker.atlassian.net/browse/GRO-282

Reviews

@akristen You should see the new url params when hovering over or clicking any of the updated pricing urls

  • Technical review
  • Editorial review
  • Product review

@netlify
Copy link

netlify bot commented Mar 11, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 554f463
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/69b2c49d734f090008431e05
😎 Deploy Preview https://deploy-preview-24339--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions bot added area/engine Issue affects Docker engine/daemon area/install Relates to installing a product area/hub Issue affects Docker Hub area/desktop Issue affects a desktop edition of Docker. E.g docker for mac area/get-started Relates to get started and onboarding docs area/subscription Relates to Docker pricing and subscription area/api Relates to Docker API docs area/admin Relates to Docker Admin area/scout Relates to Docker Scout hugo Updates related to hugo area/billing area/accounts Relates to Docker accounts area/build-cloud area/config area/guides labels Mar 11, 2026
@tiaramj tiaramj marked this pull request as ready for review March 11, 2026 19:31
Copy link
Contributor

@docker-agent docker-agent bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review Summary

Assessment: 🟢 APPROVE

This PR adds URL tracking parameters to pricing links throughout the documentation to better attribute upgrade sources. The changes are consistent and straightforward.

Analysis

  • Files changed: 46 files
  • Change type: URL parameter additions only
  • Pattern: Adding ?ref=Docs&refAction=<PageIdentifier> to https://www.docker.com/pricing/ links

Findings

No issues found. The changes:

  • ✅ Are consistent across all files
  • ✅ Do not modify any vendored content
  • ✅ Do not remove or move any pages (no redirect concerns)
  • ✅ Follow proper URL parameter syntax
  • ✅ Maintain existing link text and context
  • ✅ Use descriptive refAction values that correspond to page locations

Recommendation

The changes are ready to merge. The URL tracking parameters will help attribute documentation-driven pricing page visits to specific docs pages.

Copy link
Contributor

@akristen akristen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks so much @tiaramj !!! I'm holding off on the Approval for my own sake so @usha-mandya can look over my suggestions / changes before I do a batch commit + merge. 🖖

These links are pretty nifty too! I checked a few and they all seemed to work. :)

Changing verbiage to bypass vale blocker
Copy link
Member

@usha-mandya usha-mandya left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added some minor suggestions. Updates look good otherwise. Thank you @tiaramj and @akristen!

Co-authored-by: Alexa Kristensen <81787716+akristen@users.noreply.github.com>
Copy link
Contributor

@akristen akristen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

Copy link
Member

@usha-mandya usha-mandya left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@akristen akristen merged commit e7e28c4 into docker:main Mar 12, 2026
15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/accounts Relates to Docker accounts area/admin Relates to Docker Admin area/api Relates to Docker API docs area/billing area/build-cloud area/config area/desktop Issue affects a desktop edition of Docker. E.g docker for mac area/engine Issue affects Docker engine/daemon area/get-started Relates to get started and onboarding docs area/guides area/hub Issue affects Docker Hub area/install Relates to installing a product area/scout Relates to Docker Scout area/subscription Relates to Docker pricing and subscription hugo Updates related to hugo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants