docs(feature-flags): correct Organization / Asset relabeling controls - #15360
Merged
Conversation
The v3_relabel feature moved from environment-driven to DB-backed and self-serve, but the docs still described the old behavior. Three places were stale: * The Feature availability table listed relabeling as controlled by "Deployment configuration: DD_ENABLE_V3_ORGANIZATION_ASSET_RELABEL". That table exists to list exceptions to the self-serve rule, and relabeling is no longer one, so the row is removed. Its facts (on by default, plus which surfaces the toggle governs) move into a new "Organization / Asset Relabeling" subsection next to the toggle instructions. * The "Managed by deployment" example used relabeling, which is no longer env-managed. Swapped to DD_V3_FEATURE_LOCATIONS, which is genuinely source=env with a restart-required warning. The DD_ prefix matches what the Feature Flags page renders. * The asset hierarchy page told on-premise users to set the env var and restart, and Cloud users to email Support. It now documents both controls and what each one covers. The toggle governs the Pro UI only. The Classic UI labels, its URLs, and generated reports read DD_ENABLE_V3_ORGANIZATION_ASSET_RELABEL at process start, and no restart makes the toggle reach them: those branches live in dojo/asset/labels.py, dojo/organization/labels.py, dojo/asset/urls.py, dojo/organization/urls.py, dojo/metrics/urls.py, dojo/system_settings/labels.py, and dojo/reports/ui/urls.py, and the setting is only ever assigned from the environment in settings.dist.py. Verified by forcing the env var and the DB flag to disagree in a running instance: OSS labels followed the environment while only Pro's overlay followed the database. Also corrects two adjacent stale claims on the hierarchy page: the name change is on by default as of 3.0 rather than opt-in, and the two hierarchy pieces are still enabled by different means. Co-Authored-By: Claude <noreply@anthropic.com>
Maffooch
approved these changes
Jul 27, 2026
devGregA
approved these changes
Jul 27, 2026
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.
The
v3_relabelfeature (Organization / Asset relabeling) moved fromenvironment-driven to DB-backed and self-serve, but the docs still described the
old behavior. This corrects the three stale places.
Changes
admin/feature_flags/PRO__feature_flags.mdOrganization / Asset Relabelingrow from the "Featureavailability" table. That table lists exceptions to the self-serve rule, and
relabeling is no longer one of them.
Organization / Asset Relabelingsubsection next to the toggleinstructions, carrying the facts the removed row was holding: on by default,
and which surfaces the toggle actually governs.
DD_ENABLE_V3_ORGANIZATION_ASSET_RELABEL, which is no longer env-managed.Now uses
DD_V3_FEATURE_LOCATIONS, which genuinely is, with theDD_prefixmatching what the Feature Flags page renders.
asset_modelling/PRO_hierarchy/asset_hierarchy.mdrestart, or Cloud users to email Support. It documents both controls and what
each covers.
rather than opt-in for existing subscriptions, and the pointer for turning it
off now goes to the section that explains the controls.
The behavior being documented
The toggle governs the Pro UI only. The Classic UI labels, its URLs, and
generated reports read
DD_ENABLE_V3_ORGANIZATION_ASSET_RELABELat processstart, and no restart makes the toggle reach them. Those branches are in
dojo/asset/labels.py,dojo/organization/labels.py,dojo/asset/urls.py,dojo/organization/urls.py,dojo/metrics/urls.py,dojo/system_settings/labels.py, anddojo/reports/ui/urls.py, and the settingis only ever assigned from the environment in
settings.dist.py.Verified by forcing the env var and the DB flag to disagree in a running
instance: the OSS labels returned
Asset/Organization(following theenvironment) while only Pro's overlay followed the database.
Since both default to on and the stored value was seeded from the env var, they
agree until someone changes one, so the docs tell readers to keep them in sync
if they use both UIs.
Docs only. No code or behavior changes.
🤖 Generated with Claude Code