clearml-docs/docs/webapp/webapp_projects_page.md

60 lines
2.6 KiB
Markdown
Raw Normal View History

2021-12-21 11:42:44 +00:00
---
title: Projects Page
---
Use the Projects Page for project navigation and management.
Your projects are displayed like folders: click a folder to access its contents. The Projects Page shows the top-level
projects in your workspace. Projects that contain nested subprojects are identified by an extra nested project tab.
2023-01-25 11:25:29 +00:00
An exception is the **All Experiments** folder, which shows all projects and subprojects contents in a single, flat
2021-12-21 11:42:44 +00:00
list.
2022-03-13 13:07:06 +00:00
![Projects page](../img/webapp_project_page.png)
2021-12-21 11:42:44 +00:00
If a project has any subprojects, clicking its folder will open its own project page. Access the projects top-level
contents (i.e. experiments, models etc.) via the folder with the bracketed (`[ ]`) project name.
If a project does not contain any subprojects, clicking on its folder will open its experiment table (or [Project Overview](webapp_project_overview.md)
page when relevant).
## Project Folders
2022-03-28 09:17:15 +00:00
Project folders display summarized project information:
2021-12-21 11:42:44 +00:00
2022-03-13 13:07:06 +00:00
![Project card](../img/webapp_project_card.png)
2021-12-21 11:42:44 +00:00
When relevant, the folder has a tab which displays the number of subprojects in the project. Click the tab to view a list of
subprojects. Click on a subproject's name to navigate to it.
![Subproject tab](../img/webapp_sub_project_card.png)
2023-03-19 10:34:17 +00:00
<Collapsible title="Hidden Projects" type="configuration">
2023-03-21 10:18:15 +00:00
2023-03-15 13:11:34 +00:00
By default, ClearML infrastructure projects (i.e. dataset, pipeline, reports, application projects) are not shown in the
projects page. You can enable viewing them in **Settings > Configuration > User Preferences**. When enabled, all infrastructure projects
are labeled with <img src="/docs/latest/icons/ico-ghost.svg" alt="Hidden project" className="icon size-md space-sm" />
2023-03-21 10:18:15 +00:00
<br/>
![Hidden project configuration](../img/settings_hidden_projects.png)
2023-03-19 10:34:17 +00:00
</Collapsible>
2023-03-15 13:11:34 +00:00
2021-12-21 11:42:44 +00:00
### Project Actions
Click <img src="/docs/latest/icons/ico-bars-menu.svg" alt="Menu" className="icon size-md space-sm" /> on the top right
2022-03-28 09:17:15 +00:00
of a project folder to open its context menu and access the following project actions:
2021-12-21 11:42:44 +00:00
![Project context menu](../img/webapp_projects_context_menu.png)
2022-03-28 09:17:15 +00:00
* **Rename** - Rename the project.
* **New Project** - Create a new project (by default a subproject).
* **Move to** - Move the project into another project. If the target project does not exist, it is created on-the-fly.
* **Delete** - Delete the project. To delete a project, all of its experiments must be [archived](webapp_archiving.md) first.
2021-12-21 11:42:44 +00:00
## Create New Projects
2022-03-28 09:17:15 +00:00
To create a new project, click the **+ NEW PROJECT** button in the top right of the page or in a project's context menu,
which will open a **New Project** modal.
![New project modal](../img/webapp_projects_new_project.png)