文档

Unity Hub

Projects window reference

Explore elements and options in the Unity Hub Projects window for managing your projects.
阅读时间10 分钟最后更新于 6 天前

The Projects window displays all Unity projects you have in the Hub. Use it to create new projects, open existing ones, and manage project settings and connections.
The Projects window

The Projects window

Window header elements

The header at the top of the Projects window contains the following elements:

Element

Description

Work offlineAppears when your organization uses floating licenses. Use it to check out a license for offline use. For more information, refer to License checkout to work offline.
SearchFilters the project list by project name or path. Results update as you type. Select X in the search bar to clear the search.
AddLets you add existing projects to the Hub. The option Add project from disk opens a file browser to locate a project on your machine. The option Add from repository opens a window to add a project from a source control repository. For more information, refer to Manage your projects.
New projectOpens the New project page where you can create a project from a template. For more information, refer to Creating a new project.

Project list

Unity Hub displays projects as rows in a table. Select a project row to open it in the Unity Editor.
To view more details about a project, select the expand arrow (>) to the left of the project row. For more information, refer to Expanded project details.

Columns

The project list displays the following columns from left to right:

Column

Description

Expand/collapseSelect the arrow to expand or collapse a project row to view extra details. Select the arrow in the column header to expand or collapse all rows at once.
FavoritesDisplays a star icon. Select the star to mark or unmark a project as a favorite. You can show or hide this column in Column settings.
Source controlDisplays the source control connection status for each project. When a project is connected, the column shows the provider icon for Unity Version Control, or an external source control provider. When not connected, a broken link icon appears. Hover over the icon to view connection details or connect to a provider. You can show or hide this column in Column settings.
CloudDisplays the Unity Cloud connection status for each project. A cloud icon indicates whether the project is connected to Unity Cloud. Cloud status does not affect where your files are stored. To learn about project location, refer to Manage your projects. Hover over the icon to view connection details. You can show or hide this column in Column settings.
NameDisplays the project name (or custom display name if set), the project path, and a project icon.
BranchDisplays the source control branch the local project uses. You can show or hide this column in Column settings.
PlatformDisplays the active build platform of the project. You can show or hide this column in Column settings.
Editor versionDisplays the Unity Editor version the project was saved with. Select the version number to choose a different installed Editor version, or select Install other Editor version. For more information, refer to Download and install the Unity Editor. You can show or hide this column in Column settings.
TagsDisplays the tags you added to the project. You can show or hide this column in Column settings.
ModifiedDisplays how long ago the project was last modified. You can show or hide this column in Column settings.

Column settings

Select the gear icon to the right of the column header to open the column settings menu. This menu lets you show or hide optional columns and control which projects are displayed.

Option

Description

FavoritesShow or hide the favorites star column.
Source controlShow or hide the source control status column.
CloudShow or hide the Unity Cloud connection column.
BranchShow or hide the branch column.
PlatformShow or hide the platform column.
Editor versionShow or hide the Editor version column.
TagsShow or hide the tags column.
ModifiedShow or hide the last modified column.
Hide missing projectsWhen enabled, hides projects whose files can no longer be found at their expected location.

Sorting

Select a column header to sort the project list by that column. For text and date columns, select the same column header again to toggle between ascending and descending order. You can sort by:
  • Name: Alphabetical order.
  • Branch: Alphabetical order by branch name.
  • Platform: Alphabetical order by build platform.
  • Editor version: By Editor version number.
  • Modified: Chronological order by last modification date.
For the Favorites, Source control, and Cloud icon columns, select the header to list matching projects first, and select it again to clear the sort.

Editor version filter

If you navigate to the Projects page from the Installs page by selecting a specific Editor version, a filter appears below the header that shows the selected version. The Projects list displays only the projects that use that Editor version. Select the X on the filter to clear it and display all projects.

Expanded project details

Select the expand arrow (>) to the left of a project row to view detailed information about that project. The expanded view contains the following sections.

Configuration

Property

Description

Editor versionThe Unity Editor version the project was saved with, project architecture, and release details. Select the version to choose a different installed Editor version, or select Install other Editor version.
ModifiedThe last modification date, shown as both a relative time (for example, "3 days ago") and an absolute date and time.
Render PipelineThe render pipeline the project uses: Built-in, Universal Render Pipeline (URP), High Definition Render Pipeline (HDRP), or Scriptable Render Pipeline (SRP).
SizeThe size of the project on disk.
Custom templatesThe number of custom templates created from the project.

Connections

The Connections section appears when the project is connected to Unity Cloud or a source control provider.

Property

Description

Unity organizationThe Unity organization the project belongs to. Select the link to open the organization dashboard in your browser.
Unity Cloud projectThe Unity Cloud project name. Select the link to open the project dashboard in your browser. Select Disconnect from Unity Cloud to remove the connection.
Source control repositoryThe linked source control repository name. Select the link to open the repository in your browser. Select Disconnect from [provider] (for example, Disconnect from GitHub) to remove the connection.
Current branchThe branch that the local project uses. Available for projects connected to Unity Version Control, GitHub, or GitLab.
Git accountThe Git account the Hub uses for this project, and one of the following labels that shows where the account comes from:
  • Credential manager default: The account comes from your credential manager.
  • From organization: The account comes from the repository's organization in your Git configuration.
  • This project: The account applies to this project only.
If the project has no account, the row displays Not set and Set account. After you set an account, select Change to choose a different one. For more information, refer to Set a Git account for a project. Available for projects connected to GitHub or GitLab.
注意
Some connection actions are disabled when the project is currently open in the Unity Editor. Hover over a disabled action to find out why. Close the project in the Editor before connecting or disconnecting services.
When a project isn't connected to Unity Cloud, an informational banner titled Enable a Unity cloud project appears with an Enable cloud project button.
When a project isn't connected to source control, a Connect to source control button appears in the source control repository row.

Set a Git account for a project

By default, the Hub uses the Git account that your credential manager returns. To use a different account for a single project:
  1. In the expanded project details, in the Git account row, select Set account, or Change if the project already has an account.
  2. In the Git account for [project name] dialog, enter the account name in the Account field.
  3. Select Save.
The Hub saves the account in the Git configuration of the repository that contains the project. If multiple Unity projects share one repository, they use the same account. This account overrides any other account the project uses, such as your credential manager's default. Git, your IDE, and the Unity CLI use the same account too.
This setting is available only for projects connected to GitHub or GitLab.

Context menu

Right-click a project row or select the three-dot menu icon (⋯) on the right side of the row to open the context menu. The context menu is organized into three sections.

Common actions

Menu item

Description

Show in Explorer (Windows) / Reveal in Finder (macOS) / Show in File Browser (Linux)Opens the project folder in your system's file manager.
Add command line argumentsOpens a dialog where you can enter command line arguments that are passed to the Editor when opening this project. For more information, refer to Add command line arguments.
Set project display nameOpens a dialog to set a custom display name for the project in the Hub. For more information, refer to Set project display name.

Services

注意
If the project is currently open in the Unity Editor, the service options are disabled. Hover over a disabled option to find out why.

Menu item

Description

Enable cloud project / Disconnect from Unity CloudConnect or disconnect the project from Unity Cloud services. Requires a minimum Editor version.
Connect to source control / Disconnect from [provider]Connect or disconnect the project from a source control provider. Supported providers: Unity Version Control, GitHub, and GitLab. When disconnecting, the menu item displays the provider name (for example, Disconnect from GitHub).

Remove

Menu item

Description

Remove project from listRemoves the project from the Hub's project list. The project files remain on your machine. A confirmation dialog appears before the project is removed.

Set project display name

You can set a custom display name for a project in the Unity Hub. This name appears only in the Hub and doesn't change the project's folder name or file paths.
To set a display name:
  1. Right-click the project or select the three-dot menu icon (⋯).
  2. Select Set project display name.
  3. Enter a display name in the text field.
  4. Select Save.
To restore the original folder name, open the Set project display name dialog, select Clear, and save.

Project warnings and errors

If there are issues with a project, the Hub displays them on the project row or in a dialog when you open the project.

Issue

Description

Project not foundThe project files weren't found at the specified location. The project folder may have been moved, renamed, or deleted. The project row displays a label, and the Hub displays a dialog if you try to open the project.
Missing Editor versionThe Editor version used by the project is not installed. Install the required version or open the project with a different version.
Project is currently openThe project is currently open in another Unity Editor instance. The Hub displays a dialog when you try to open it again. Close the Editor to proceed with certain operations.