> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Cognite Data Fusion (CDF) is an industrial DataOps platform. Prefer English docs unless the user asks for another locale.
> Follow /_llms/ index links recursively until you reach page URLs ending in .md. Fetch those Markdown twins instead of HTML.
> For REST APIs, default to calendar version 20230101 (stable). Use 20230101-beta or 20230101-alpha only if the user is on a preview API. Cite paths under /api-reference/concepts/<version>/ and the Cdf-Version header. Prefer the Python SDK (cognite-sdk) unless the user is in JavaScript/TypeScript.
> Start here by task: platform overview /cdf/index.md; data modeling /cdf/dm/index.md; data integration /cdf/integration/index.md; access /cdf/access/index.md; CDF Toolkit /cdf/deploy/cdf_toolkit/index.md; REST quickstart /dev/quickstart.md; Python SDK https://cognite-sdk-python.readthedocs-hosted.com/en/stable/; Atlas AI /cdf/atlas_ai/index.md; plan an Atlas AI agent /cdf/atlas_ai/concepts/atlas_ai_agent_planning.md; Flows apps /cdf/flows/index.md; MCP and IDE setup /dev/guides/ide_ai_integration.md.
> For implementation work, also load /skill.md.

# About the Home page and dashboards

> Learn about the Home page in Flows and how dashboards bring together the data and apps you use for a role or task. You can share dashboards with your team and, with Atlas AI enabled, ask questions and create widgets from a description.

Home is where your work starts in Flows. Checking how things are running on site often means opening several apps, such as Search, Charts, Canvas, and the [custom apps](https://docs.cognite.com/cdf/explore/custom_apps.md) your organization has built. On Home, you bring the data and apps you use regularly together on one dashboard, so everything you need is in one place as soon as you sign in.

For example, a maintenance planner can put a chart of the work order backlog, KPI cards for critical equipment, and an app launcher for their planning apps on one dashboard. When you share a dashboard, your team works from the same view. To see how other roles can use dashboards, see [Example dashboards](#example-dashboards).

To get to the Home page, sign in to [Cognite Data Fusion (CDF)](https://fusion.cognite.com) or open a link to a dashboard a colleague has shared with you. To share your own dashboards, see [Share a dashboard](#share-a-dashboard).

## What's on the Home page

On the Home page, you find dashboards created for you, which you can use as they are, and your own dashboards. You can create a dashboard from scratch or copy one that someone else created and edit your copy.

![Flows workspace Home page with the search box, existing dashboards, and an empty dashboard ready for widgets](https://apps-cdn.cogniteapp.com/@cognite/docs-portal-images/1.0.0/images/cdf/explore/dashboard_example.png)

Some features are available to everyone, and others are added when your organization has Atlas AI enabled.

> [tab] For everyone
>
> * **Search**, to find your data.
> * **Dashboards**, created for you or by you.
> * **Widgets**, such as data visualizations, Flows custom apps, an app launcher, and your recent activity. See [Build a dashboard](#build-a-dashboard).
> * **Sharing**, to let colleagues or everyone in your organization view a dashboard and copy it as a starting point for their own.
> * **Mobile access**, to open the Flows workspace and your dashboards on a mobile device.

> [tab] With Atlas AI
>
> Everything that's available to everyone, plus:
>
> * **Ask Atlas**, in the search box and on individual widgets, to ask questions and start investigations.
> * **Chat**, from the sidebar, for longer conversations. See [Chat with Atlas AI](https://docs.cognite.com/cdf/flows_workspace/atlas_chat.md).
> * **Smart widget**, to have Atlas AI track a question or task on a dashboard, for example, a handover summary from the last shift.
>
> If your organization has Atlas AI enabled but you don't see these features, ask your CDF admin to check that you have the [Atlas AI capabilities](https://docs.cognite.com/cdf/access/guides/capabilities.md#atlas-ai).

## Search or ask Atlas AI

Use the box at the top of the Home page to search and analyze data yourself, or ask Atlas AI:

* **Search.** Enter an asset ID, file name, or keyword, and press Enter to open the results in [Search](https://docs.cognite.com/cdf/explore/search.md). From there, you can filter, preview, and explore your data.
* **Ask Atlas.** Ask a question or describe what you need, then select Ask Atlas. Atlas AI can answer your question, start an investigation, or create widgets for you when you ask it to.

For example, enter *Why did the discharge pressure on pump 23-PA-9101 drop last week?* and select Ask Atlas. Atlas AI looks at the pump's time series, related work orders, and documents, and answers with citations you can open to check the source.

## Dashboards

A dashboard is a set of widgets arranged on one page. Instead of rebuilding the same view every time you need it, you arrange the widgets for a role or task once, and the data and apps are ready whenever you open the Home page. You can share dashboards with colleagues and teams.

### Example dashboards

These examples show what different roles can use a dashboard for and which widgets they add to it:

* **Shift supervisor.** To start each shift with a handover summary and continue earlier work where they left off, a shift supervisor adds a Smart widget that summarizes the last shift, a gauge for key process values, and a Recent activity widget. The Smart widget requires Atlas AI.
* **Reliability engineer.** To compare equipment trends with open issues on the same page, a reliability engineer adds line charts of key equipment trends, a table of open issues, and an app launcher to open Canvas and investigate further.
* **Operations manager.** To review the same numbers with the team in meetings, an operations manager adds KPI cards and area charts for the site and shares the dashboard with the whole team.

### Explore existing dashboards

Browse the dashboards available to you, including dashboards that others have shared with you. To create your own version that you can edit, copy a dashboard. To keep a dashboard within reach, pin it to your tab bar.

### Build a dashboard

Your first dashboard is created together with your first widget. To create it, do one of the following:

* Select Create with Atlas. In the dialog that opens, describe the goal of the widget, and Atlas AI creates it for you.
* Select Create widget, and then select a widget type.

After you have a dashboard, either one you created or one you pinned, select + Create dashboard to add more dashboards.

To add widgets to a dashboard you created or copied, use the Add menu. You can add these widget types:

* **Visualization.** Select a table, vertical bar chart, line chart, area chart, pie chart, gauge, or KPI card.
* **Flows custom app.** Select Flows app, and then select the [Flows custom app](https://docs.cognite.com/cdf/flows.md) you want to embed on the dashboard as a live widget.
* **App launcher.** Add one widget that opens all the apps you use. The widget can include:

  * Apps, such as Canvas, Charts, Search, and 3D. These are included by default.
  * Your organization's Flows custom apps.
  * Links to other apps you use, for example, [Cognite InField](https://docs.cognite.com/cdf/infield.md) and [Cognite Maintain](https://docs.cognite.com/cdf/maintain.md), and other apps that aren't part of CDF.

  Edit the widget at any time to add or remove apps.
* **Recent activity.** Show your recent searches, canvases, and charts. With Atlas AI, it also shows your recent conversations. Select an item to continue where you left off.
* **Ask Atlas.** Open a chat with Atlas AI, describe what you want to see, and work out the widget together in the conversation.
* **Smart widget.** Enter a question or task for Atlas AI to track, for example, *Provide a handover summary from the last shift*. Atlas AI fetches the data and shows the answer in the widget, using the dashboard's current date range and location filters. From the widget, you can refresh the answer with the latest data or explore it further with Atlas AI.

When your dashboard is ready, share it so your colleagues can view it too. See [Share a dashboard](#share-a-dashboard).

### Manage and share dashboards

Use the controls in the upper-right corner of a dashboard to change the dashboard and share it with others.

#### Manage a dashboard

On a dashboard you created or copied, you can:

* Select Add to add widgets.
* Select Manage layout to move widgets around and resize them.
* Open the options menu  to edit, import, export, duplicate, or delete the dashboard, or to set it as your default.

You can also add widgets and change the layout while you edit the dashboard.

#### Share a dashboard

To share the dashboard, select the share icon  next to the options menu, and then do one of the following:

![Share dashboard dialog with options to invite people by email address, copy the link, and make the dashboard public](https://apps-cdn.cogniteapp.com/@cognite/docs-portal-images/1.0.0/images/cdf/explore/share_dashboard.png)

➀ **Invite people by email address.** Enter the email addresses of the people you want to share the dashboard with. Each person gets an email with a link to the dashboard and can view it. To make changes, they copy it to create their own editable version.

➁ **Copy the link.** Select Copy link and send it by email or in a chat. People you've shared the dashboard with can open it directly from the link.

➂ **Make the dashboard public.** Select Make public so everyone in your CDF project and organization can find and view the dashboard. A public dashboard isn't available to anyone outside your organization.

## Requirements

The Home page works with CDF projects that store data in the [core data model](https://docs.cognite.com/cdf/dm/dm_reference/dm_core_data_model.md), the [process industries data model](https://docs.cognite.com/cdf/dm/dm_reference/dm_process_industry_data_model.md), or extensions of these data models.

Your CDF admin should also set up [location filters](https://docs.cognite.com/cdf/locations.md) for the project:

* Configure location filters to divide the project's data into meaningful areas, such as plants or production units.
* Give every user access to at least one location filter that uses the core data model, the process industries data model, or an extension of these data models.

If your organization uses Atlas AI, location filters are required for the [default Atlas agent](https://docs.cognite.com/cdf/atlas_ai/concepts/about_default_atlas_agent.md) ([private preview](https://docs.cognite.com/cdf/product_feature_status.md#private-preview)).

## Further reading

* [Flows workspace](https://docs.cognite.com/cdf/flows_workspace/flows_workspace.md)
* [Chat with Atlas AI](https://docs.cognite.com/cdf/flows_workspace/atlas_chat.md)
* [Custom apps](https://docs.cognite.com/cdf/explore/custom_apps.md)
* [Atlas AI capabilities](https://docs.cognite.com/cdf/access/guides/capabilities.md#atlas-ai)
