langchain-ai · Florence Morris (fjmorris) · Aug 31, 2026 · Sep 1, 2026 · Sep 1, 2026 · Sep 1, 2026
diff --git a/src/langsmith/filter-traces-in-application.mdx b/src/langsmith/filter-traces-in-application.mdx
@@ -3,8 +3,12 @@ title: Filter traces
 sidebarTitle: Filter traces
 ---
 
+import FilteringExperienceNote from '/snippets/langsmith/filtering-experience-note.mdx';
+
 Tracing projects can accumulate large amounts of data across [threads](/langsmith/observability-concepts#threads), [traces](/langsmith/observability-concepts#traces), and [runs](/langsmith/observability-concepts#runs). LangSmith's filtering tools let you navigate and analyze that data precisely.
 
+<FilteringExperienceNote />
+
 This page covers:
 
 - [Applying filters from the filter bar](#create-and-apply-filters) and **Filter Shortcuts** panel

diff --git a/src/langsmith/filter-traces.mdx b/src/langsmith/filter-traces.mdx
diff --git a/src/langsmith/images/filter-multiple-scopes-dark.png b/src/langsmith/images/filter-multiple-scopes-dark.png
diff --git a/src/langsmith/images/filter-multiple-scopes-light.png b/src/langsmith/images/filter-multiple-scopes-light.png
diff --git a/src/langsmith/images/filter-scope-selector-dark.png b/src/langsmith/images/filter-scope-selector-dark.png
diff --git a/src/langsmith/images/filter-scope-selector-light.png b/src/langsmith/images/filter-scope-selector-light.png
diff --git a/src/langsmith/images/filter-search-bar-dark.png b/src/langsmith/images/filter-search-bar-dark.png
diff --git a/src/langsmith/images/filter-search-bar-light.png b/src/langsmith/images/filter-search-bar-light.png
diff --git a/src/langsmith/images/filter-shortcuts-panel-dark.png b/src/langsmith/images/filter-shortcuts-panel-dark.png
diff --git a/src/langsmith/images/filter-shortcuts-panel-light.png b/src/langsmith/images/filter-shortcuts-panel-light.png
diff --git a/src/langsmith/images/filter-trace-highlighting-dark.png b/src/langsmith/images/filter-trace-highlighting-dark.png
diff --git a/src/langsmith/images/filter-trace-highlighting-light.png b/src/langsmith/images/filter-trace-highlighting-light.png
diff --git a/src/snippets/langsmith/filtering-experience-note.mdx b/src/snippets/langsmith/filtering-experience-note.mdx
@@ -0,0 +1,6 @@
+<Note>
+Tracing projects have two filtering experiences. Check the top of your project to see which one applies to you:
+
+- **A single search bar with a scope selector to its left**: Refer to [Filter traces](/langsmith/filter-traces).
+- **An Add filter button that builds filter chips**: Refer to [Filter traces in application](/langsmith/filter-traces-in-application).
+</Note>