docs/features/feature-guides/views/overview.md
import FeatureAvailability from '@site/src/components/FeatureAvailability';
Views let you save a set of filters and reuse them across DataHub. When you activate a View, search results, browse pages, recommendations, and other asset lists are automatically narrowed to only the matching assets.
<p align="center"> </p>Why use Views?
| Type | Visible to | Who can create | Can be set as |
|---|---|---|---|
| Public (Global) | All users | Admins only | User, org, or service account default |
| Personal (Private) | Only the creator | Any user | User default only |
Any user can create personal views for their own use. Public views are shared across the organization and require the Manage Public Views platform privilege, which is granted to admins by default.
You can also save your current search filters as a View directly from the search results page.
Open the View selector and click the ... menu next to any View to rename it, update its filters, or delete it. Personal views can only be modified by their creator. Public views can be managed by any admin with the Manage Public Views privilege.
<p align="center"> </p>An active View filters what you see across search results, the home page, domain pages, data product pages, quick filters, and entity counts in the navigation bar.
You can set a default View so it's applied automatically whenever you open DataHub, start an Ask DataHub conversation, or query through the MCP server. Defaults work at two levels.
Any user can pick their own default via the ... menu > Make my default. This can be any public or personal View.
<p align="center"> </p>A personal default always takes priority over the organization default.
Admins can designate one public View as the organization-wide default via the ... menu > Make organization default. This kicks in for any user who hasn't chosen their own default. Requires the Manage Public Views privilege.
<p align="center"> </p>You can always switch or clear the active View during a session.
In Ask DataHub, click the View selector next to the chat input to pick any personal or public View. That View will scope every search the AI assistant makes during the conversation.
<p align="center"> </p>If you don't select a View, the organization default is used (when one is set).
:::note Slack & Microsoft Teams In Slack and Microsoft Teams, the organization default View is always applied automatically. :::
You can assign a View to a service account so that all searches made through the MCP server are scoped to that View.
If no view is set on the service account, the organization default is used instead.
:::info Public Views Only Only public (global) views can be assigned to service accounts. Personal views are not supported. :::
Example use cases:
Go to Settings > My Views to see all your personal and public views in one place. From here you can create, edit, delete, or change defaults.
<p align="center"> </p>| Action | Who can do it |
|---|---|
| Create a personal view | Any user |
| Create a public view | Admins with Manage Public Views |
| Edit / delete a personal view | The user who created it |
| Edit / delete a public view | Admins with Manage Public Views |
| Set personal default | Any user (for themselves) |
| Set organization default | Admins with Manage Public Views |
| Set service account default view | Admins with Manage Service Accounts |
When using the CLI or GraphQL API directly, default Views are not applied automatically — you need to pass the View URN explicitly.
Use the --view flag when searching:
datahub search "*" --view "urn:li:dataHubView:my-view-id"
See the CLI search documentation for more details.
Pass the viewUrn parameter on any search query:
{
searchAcrossEntities(
input: { query: "*", count: 10, viewUrn: "urn:li:dataHubView:my-view-id" }
) {
total
searchResults {
entity {
urn
type
}
}
}
}
viewUrn is supported on searchAcrossEntities, scrollAcrossEntities, aggregateAcrossEntities, browseV2, and other search-related queries.