> For the complete documentation index, see [llms.txt](https://v2.dataos.info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://v2.dataos.info/consume/discover/search-the-hub.md).

# Search the Hub

Search the Hub to find Data Products, [Perspectives](/consume/discover/search-the-hub/perspectives.md), and Metrics by name, topic, tag, or intent. The Hub is useful when you already know part of what you need: a product name, domain, business topic, or keyword.

{% hint style="success" %}
Confirm that the required Tenant is selected and that Data Products are available. If access or availability is not confirmed, start with [Before you begin](/consume/get-started/readme-1.md).
{% endhint %}

{% stepper %}
{% step %}

<details open>

<summary><strong>Start from the Hub</strong></summary>

From the DataOS Home page, select Products to open the Hub experience for Data Products.

<figure><img src="/files/7GbquxAw7u51LnmhsOD4" alt=""><figcaption></figcaption></figure>

The Products page lists all Data Products available in the selected Tenant as cards in a grid.

![](/files/2H5RVGzrdZixIpWj7Kq9)

</details>
{% endstep %}

{% step %}

<details>

<summary><strong>Search scope</strong></summary>

Before you search, confirm what you are looking for. By default, the Hub searches Data Products. Open the scope selector using the icon next to the search field to switch to a different entity type. The scope selector offers **Data Products**, **Perspectives**, and **Metrics**.

<img src="/files/2vLA3k2ZYri17eRNQHgg" alt="" width="302">

&#x20;

<img src="/files/JFFb8yNltLYPVr3gIaWk" alt="" width="302">

Use **Perspectives** to find a saved, governed query that already answers your question. Use **Metrics** to find a ready-made business measure without writing a query.

</details>
{% endstep %}

{% step %}

<details>

<summary><strong>Card details</strong></summary>

Each card gives you enough signal to decide whether a product is worth opening, without leaving the list. A card displays:

* A product icon and the product name, so you can recognize the product at a glance.
* A short description, so you can judge whether the product covers your use case.
* A **Quality** indicator that warns you up front when the product has open data quality issues.
* A **Last run** indicator that warns you when the product's most recent run failed, so you can avoid stale or broken outputs.

On hover, cards show an info (**i**) icon in the top-right corner so you can preview details before opening the product.

Not all indicators appear on every card. A card with no indicators is a quick signal that the product has no active quality issues and its last run succeeded.

</details>
{% endstep %}

{% step %}

<details>

<summary><strong>Switch to list view</strong></summary>

Switch the view to match how you are scanning. Use the view toggle at the top right of the product list to move between grid and list views.

![](/files/ExuMJhhqI8rAkEgJwqV1)

Grid view favors visual browsing, while list view shows products as rows with columns for the product name, glossary term, and status indicators. Use list view when you need to scan names and glossary terms quickly across a large set of products.

</details>
{% endstep %}

{% step %}

<details>

<summary><strong>My data products</strong></summary>

When you only care about the products you work on, select My data products next to the All tab to cut the list down to the Data Products you own or have been added to as a member.

</details>
{% endstep %}

{% step %}

<details>

<summary><strong>Filter the list</strong></summary>

When the Hub holds too many products to scan, filters help you focus on only the ones that fit your context. Click the filter icon to expand the panel.

![](/files/wY076WijLwDPn3HLqtby)

Narrow by metadata such as domain, type, quality, last run status, tags, and members, and combine several filters at once to zero in on a relevant set. For a detailed walkthrough of each filter category, see [Filters](/consume/discover/search-the-hub/filters.md).

</details>
{% endstep %}

{% step %}

<details>

<summary><strong>Search by keyword</strong></summary>

When you already know part of what you need, type in the search field to jump straight to products by name, description, tags, or business topic.

As you type, the Hub narrows the list to matching results and shows a count of the products found, so you can quickly gauge how specific your search is.

![](/files/otoy6Q9hhXCI0VRj06vD)

</details>
{% endstep %}

{% step %}

<details>

<summary><strong>Perspectives</strong></summary>

{% hint style="info" %}
A Perspective is a saved, governed query built on a Data Product's semantic layer. It preserves the selected dimensions, measures, filters, and time window so the same result can be reused, shared, or consumed through a Data API. See [Perspectives](/consume/discover/search-the-hub/perspectives.md) for details.
{% endhint %}

When the search scope is set to Perspectives, the Hub lists the Perspectives available in the Tenant so you can reuse a saved, governed query instead of building one yourself. Filter them, open a Perspective to preview its details, and select Know more to open the full Perspective page.

![](/files/CpjhNhA88Gk0fvi5X7fk)

For a detailed walkthrough of browsing and filtering Perspectives, see [Perspectives](/consume/discover/search-the-hub/perspectives.md).

</details>
{% endstep %}

{% step %}

<details>

<summary><strong>Metrics</strong></summary>

When the search scope is set to **Metrics**, the Hub lists the Metrics available in the Tenant so you can pick up a ready-made business measure without writing a query. Filter them, open a Metric to preview its details, and select Open in Studio to explore it further in the Studio query interface.

![](/files/Kwy9azOdzTcQBk1DabUZ)

For a detailed walkthrough of browsing and filtering Metrics, see [Metrics](/consume/discover/search-the-hub/metrics.md).

</details>
{% endstep %}

{% step %}

<details>

<summary><strong>Open a product</strong></summary>

Once a product looks promising, select its card or row to open the product page and confirm it is the right fit. Continue to the understanding stage, where the product overview, [assets](/consume/understand/assets.md), [quality](/consume/understand/quality.md), [activity](/consume/understand/activity.md), and run history help you decide whether the Data Product is trustworthy and fit for use.

</details>
{% endstep %}
{% endstepper %}

## Next steps

After you open a Data Product, continue with:

* [Explore assets](/consume/understand/assets.md)
* [Trust & Freshness](/consume/understand/quality.md)
* [Track activity](/consume/understand/activity.md)
* [Query in Studio](/consume/understand/overview.md)
* [Understand with AI](/consume/understand/understand-and-trust-with-ai.md)
* [Consumer journey](/consume/get-started/readme.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://v2.dataos.info/consume/discover/search-the-hub.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
