Skip to content

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

Open
tiaramj wants to merge 5 commits intodocker:mainfrom
tiaramj:tiara/gro-282
Open

Update pricing url with ref and refAction params [GRO-282]#24339
tiaramj wants to merge 5 commits intodocker:mainfrom
tiaramj:tiara/gro-282

Conversation

@tiaramj
Copy link

@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 f96d254
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/69b1c5bc7b90890008532d02
😎 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
@@ -54,7 +54,7 @@ The following diagram shows the relationship between a registry, repositories, a

> [!NOTE]
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
> [!NOTE]
> [!TIP]

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.

> [!NOTE]
>
> You can create one private repository and unlimited public repositories using the free version of Docker Hub. For more information, visit the [Docker Hub subscription page](https://www.docker.com/pricing/).
> You can create one private repository and unlimited public repositories using the free version of Docker Hub. For more information, visit the [Docker Hub subscription page](https://www.docker.com/pricing?ref=Docs&refAction=DocsConceptsRegistry).
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
> You can create one private repository and unlimited public repositories using the free version of Docker Hub. For more information, visit the [Docker Hub subscription page](https://www.docker.com/pricing?ref=Docs&refAction=DocsConceptsRegistry).
> A Docker Personal plan gives you one private repository and unlimited public repositories. You can learn about unlimited private repos by checking out the [Docker Team plan](https://www.docker.com/pricing?ref=Docs&refAction=DocsConceptsRegistry).

Copy link
Contributor

Choose a reason for hiding this comment

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

idk i'm just riffing here. maybe @usha-mandya you can get this a little closer to there 😅

Docker subscriptions provide features and benefits for individual developers, teams, and enterprise businesses. This page explains how to set up subscriptions for personal accounts and organizations.

Before you begin, make sure you have a [Docker ID](../accounts/create-account.md). To learn more about what's included with each tier, see [Docker Pricing](https://www.docker.com/pricing/).
Before you begin, make sure you have a [Docker ID](../accounts/create-account.md). To learn more about what's included with each tier, see [Docker Pricing](https://www.docker.com/pricing?ref=Docs&refAction=DocsSubscriptionSetup).
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Before you begin, make sure you have a [Docker ID](../accounts/create-account.md). To learn more about what's included with each tier, see [Docker Pricing](https://www.docker.com/pricing?ref=Docs&refAction=DocsSubscriptionSetup).
Before you begin, make sure you have a [Docker ID](../accounts/create-account.md). To learn more about what each tier gives you, check out the [Docker Pricing](https://www.docker.com/pricing?ref=Docs&refAction=DocsSubscriptionSetup) page.

@@ -127,7 +127,7 @@ product line.

> [!NOTE]
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
> [!NOTE]
> [!TIP]

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
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.

2 participants