From f38ce29b61988e075122a13f65b528586d3b22b4 Mon Sep 17 00:00:00 2001
From: David An <a-daan@expediagroup.com>
Date: Tue, 28 Mar 2023 11:50:34 -0600
Subject: [PATCH] add notes about picker and filter

Signed-off-by: David An <a-daan@expediagroup.com>
---
 .changeset/funny-trains-sniff.md | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/.changeset/funny-trains-sniff.md b/.changeset/funny-trains-sniff.md
index 1021ad061d..91dbd28c28 100644
--- a/.changeset/funny-trains-sniff.md
+++ b/.changeset/funny-trains-sniff.md
@@ -3,4 +3,23 @@
 '@backstage/plugin-catalog': minor
 ---
 
-Added namespace filter and column in default catalog table
+Added an entity namespace filter and column on the default catalog page.
+
+If you have a custom version of the catalog page, you can add this filter in your CatalogPage code:
+
+```ts
+<CatalogFilterLayout>
+  <CatalogFilterLayout.Filters>
+    <EntityTypePicker />
+    <UserListPicker initialFilter={initiallySelectedFilter} />
+    <EntityTagPicker />
+    /* if you want namespace picker */
+    <EntityNamespacePicker />
+  </CatalogFilterLayout.Filters>
+  <CatalogFilterLayout.Content>
+    <CatalogTable columns={columns} actions={actions} />
+  </CatalogFilterLayout.Content>
+</CatalogFilterLayout>
+```
+
+The namespace column can be added using `createNamespaceColumn();`. This is only needed if you customized the columns for CatalogTable.