[hnrkndrssn]

Background

Octopus Server has set three tag set variables since 2025.4. They came in OctopusDeploy/OctopusDeploy#37164 and OctopusDeploy/OctopusDeploy#37529. The System variables page doesn't list any of them. A customer found Octopus.Environment.TagSets[tag set].Tags only by reading a deployment's variable manifest. They asked if they can rely on the variable. They also asked what the value looks like when an environment has more than one tag in the tag set.

Relates to FD-1065

Results

Adds Octopus.Environment.TagSets[tag set].Tags, Octopus.Project.TagSets[tag set].Tags, and Octopus.Tenant.TagSets[tag set].Tags to the Deployment variables table. Version notes list the first build for each.

Each row says the value is the tag names separated by commas. The order of the tags isn't guaranteed. The environment row also says an == comparison only matches when the environment has a single tag in the tag set. That was the customer's main question.

How to review this PR

General quality. The value format comes from CollectTagSetVariables in VariableCollectionUtilities.cs in OctopusDeploy. The version boundaries are the first builds that contain #37164 and #37529.

Reducing risk

• Spellcheck passes

🤖 Generated with Claude Code

[team-marketing-branch-protections]

Pull request environment is available at https://stoctodocspr3567.z22.web.core.windows.net/.

You can view the ephemeral environment status in Octopus Deploy.

This environment will be automatically deprovisioned when the pull request is closed, or after 7 days of inactivity.