From c22bf7a857ba7adcbbe97ba0d5eed329512ab822 Mon Sep 17 00:00:00 2001 From: Tatiana Inama Date: Tue, 28 Apr 2026 16:02:20 +0200 Subject: [PATCH 1/2] docs: remove Saved Trees experimental flag and update Canvas view flow The saved-metrics-tree feature flag is being removed and Saved Trees become the only Canvas surface. Refresh the guide to drop the alpha tag, reframe the "How to use" steps around picking or creating a tree, and call out the auto-migrated "Project Metrics" tree for projects upgrading from the legacy ad-hoc canvas. --- guides/metrics-catalog/canvas.mdx | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/guides/metrics-catalog/canvas.mdx b/guides/metrics-catalog/canvas.mdx index 323d0479..91031763 100644 --- a/guides/metrics-catalog/canvas.mdx +++ b/guides/metrics-catalog/canvas.mdx @@ -3,27 +3,28 @@ title: "Canvas" description: "Use the Canvas view to visualize metric relationships, hierarchies, and dependencies in a flexible workspace." --- -The **Canvas View** is a flexible workspace for visualizing and organizing metrics. You can use it to build **Metric Trees** that show how metrics relate to each other, visualize hierarchies, and understand dependencies across your data model. +The **Canvas View** is a flexible workspace for visualizing and organizing metrics. You can use it to build **Saved Trees** that show how metrics relate to each other, visualize hierarchies, and understand dependencies across your data model. ### How to use the Canvas view -1. **Filter your metrics**: Use the search bar, categories, or table filters to narrow down the list. Use the search bar, categories, or table filters to narrow down the list. Categories help you group and label related metrics, making it easier to find what you need. Need help creating categories? [Learn more here](/guides/metrics-catalog/catalog#browsing-the-catalog). -2. **Enable Canvas view**: Switch to the Canvas view toggle in the metrics catalog. -3. **Add metrics**: Drag metrics from the sidebar into the canvas workspace. -4. **Create connections**: Drag between node handles to draw edges representing relationships and dependencies. -5. **Remove nodes**: Select a node and press **Backspace** to delete it. +1. **Open the Canvas view**: Switch to the Canvas view toggle in the metrics catalog. The left rail lists every Saved Tree in the project. +2. **Open or create a tree**: Click an existing tree to open it, or click **New Tree** to start a fresh one (which puts you in edit mode). +3. **Filter your metrics** *(edit mode)*: Use the search bar, categories, or table filters to narrow down the sidebar. Categories help you group and label related metrics, making it easier to find what you need. Need help creating categories? [Learn more here](/guides/metrics-catalog/catalog#browsing-the-catalog). +4. **Add metrics**: Drag metrics from the sidebar into the canvas workspace. Click **Load more** at the bottom of the sidebar to pull additional metrics from the catalog. +5. **Create connections**: Drag between node handles to draw edges representing relationships and dependencies. +6. **Remove nodes**: Select a node and press **Backspace** to delete it. Viewers can see trees and connections but cannot make edits. -## Saved Trees - - **Experimental:** Saved Trees is behind a feature flag. Reach out to support to enable it for your organization. Learn more about [Feature Maturity Levels](/references/workspace/feature-maturity-levels). + Projects that drew metric relationships in earlier versions of the Canvas view will find them under an auto-created Saved Tree named **Project Metrics**. -Saved Trees are named, persistent canvas layouts that preserve your metric arrangements and connections. Unlike the ad-hoc canvas — where unconnected node positions reset between sessions — Saved Trees store the full layout including every node position and edge. +## Saved Trees + +Saved Trees are named, persistent canvas layouts that preserve your metric arrangements and connections. They store the full layout — every node position and every edge — so you can return to the same view next session and share the link with teammates. Saved Trees are shared across your team: anyone with access to the project can view them, and users with the right permissions can create, edit, and delete them. From 7aaf1a7a4b4bcc0a40d245047badf5dce7350eae Mon Sep 17 00:00:00 2001 From: Tatiana Inama Date: Tue, 28 Apr 2026 16:51:12 +0200 Subject: [PATCH 2/2] docs: drop Project Metrics migration callout from Canvas guide --- guides/metrics-catalog/canvas.mdx | 4 ---- 1 file changed, 4 deletions(-) diff --git a/guides/metrics-catalog/canvas.mdx b/guides/metrics-catalog/canvas.mdx index 91031763..7753b2e8 100644 --- a/guides/metrics-catalog/canvas.mdx +++ b/guides/metrics-catalog/canvas.mdx @@ -18,10 +18,6 @@ The **Canvas View** is a flexible workspace for visualizing and organizing metri Viewers can see trees and connections but cannot make edits. - - Projects that drew metric relationships in earlier versions of the Canvas view will find them under an auto-created Saved Tree named **Project Metrics**. - - ## Saved Trees Saved Trees are named, persistent canvas layouts that preserve your metric arrangements and connections. They store the full layout — every node position and every edge — so you can return to the same view next session and share the link with teammates.