Add doc to extended tagset feature #2864
Draft
Conversation
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
hnrkndrssn
requested changes
Oct 9, 2025
Comment on lines
+11
to
+15
| This page covers how to use tags with tenants. For general information about tag sets, types, and scopes, see [Tag sets](/docs/tenants/tag-sets). | ||
|
|
||
| - Find tenants faster using tenant tag filters. | ||
| :::div{.hint} | ||
| Tag set types (SingleSelect and FreeText) require Octopus Deploy version **2025.4.3897** or later with the `extended-tag-sets` feature toggle enabled. Without this feature, all tag sets use MultiSelect type with predefined tags only. | ||
| ::: |
There was a problem hiding this comment.
Suggested change
| This page covers how to use tags with tenants. For general information about tag sets, types, and scopes, see [Tag sets](/docs/tenants/tag-sets). | |
| - Find tenants faster using tenant tag filters. | |
| :::div{.hint} | |
| Tag set types (SingleSelect and FreeText) require Octopus Deploy version **2025.4.3897** or later with the `extended-tag-sets` feature toggle enabled. Without this feature, all tag sets use MultiSelect type with predefined tags only. | |
| ::: | |
| :::div{.hint} | |
| This page covers how to use tags with tenants. For general information about tag sets, types, and scopes, see [Tag sets](/docs/tenants/tag-sets). | |
| From Octopus Cloud version **2025.4.3897** we've introduced **SingleSelect** and **FreeText** tag set types. This functionality is behind the `Extended Tag Sets` feature toggle, to request this functionality early, please contact [support](https://octopus.com/support). | |
| ::: |
Comment on lines
+101
to
+112
| ### What are tenant tags? | ||
|
|
||
| Tenant tags are a form of metadata you can add to tenants to classify them. Tenant tags allow you to: | ||
|
|
||
| - Find tenants faster using tenant tag filters. | ||
| - Group a project's deployments overview by tag set. | ||
| - Deploy to multiple tenants at the same time. | ||
| - Customize deployment processes for tenants. | ||
| - Scope project variables to tags. | ||
| - Design a multi-tenant hosting model - read more in our [tenant infrastructure](/docs/tenants/tenant-infrastructure) section. | ||
| - Design a multi-tenant deployment process for SaaS applications, regions and more - for further details, see our [guides](/docs/tenants/guides/#guides). | ||
| - Control which releases can be deployed to tenants using [channels](/docs/releases/channels/) - read more in our [tenant lifecycle](/docs/tenants/tenant-lifecycles) section. |
There was a problem hiding this comment.
This duplicates the section on /docs/tenants/tenant-tags
Suggested change
| ### What are tenant tags? | |
| Tenant tags are a form of metadata you can add to tenants to classify them. Tenant tags allow you to: | |
| - Find tenants faster using tenant tag filters. | |
| - Group a project's deployments overview by tag set. | |
| - Deploy to multiple tenants at the same time. | |
| - Customize deployment processes for tenants. | |
| - Scope project variables to tags. | |
| - Design a multi-tenant hosting model - read more in our [tenant infrastructure](/docs/tenants/tenant-infrastructure) section. | |
| - Design a multi-tenant deployment process for SaaS applications, regions and more - for further details, see our [guides](/docs/tenants/guides/#guides). | |
| - Control which releases can be deployed to tenants using [channels](/docs/releases/channels/) - read more in our [tenant lifecycle](/docs/tenants/tenant-lifecycles) section. |
Comment on lines
+97
to
+99
| ## Tenant tags without extended features {#tag-sets-without-extended-features} | ||
|
|
||
| If you're running Octopus Deploy version earlier than **2025.4.3897** or the `extended-tag-sets` feature toggle is disabled, the feature is called **Tenant tags** (not Tag sets) and uses the original behavior described below. |
There was a problem hiding this comment.
Does this add any value?
Co-authored-by: Henrik Andersson <henrik.andersson@octopus.com>
Co-authored-by: Henrik Andersson <henrik.andersson@octopus.com>
HuyPhanNguyen
changed the title
Co-authored-by: Henrik Andersson <henrik.andersson@octopus.com>
Co-authored-by: Henrik Andersson <henrik.andersson@octopus.com>
….mdx Co-authored-by: Henrik Andersson <henrik.andersson@octopus.com>
Co-authored-by: Henrik Andersson <henrik.andersson@octopus.com>
Co-authored-by: Henrik Andersson <henrik.andersson@octopus.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
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.
No description provided.