Troubleshooting

This page describes problems you might encounter when you use the Collaboration Tools package, and how to solve them.

Opening the tools

I can't find the Collaboration button in the main toolbar

  • On Unity 6000.0 to 6000.2, the main toolbar button isn't available. Open the window from the Unity Cloud > Collaboration menu instead.

    The Unity Cloud menu with the Collaboration entry

  • On Unity 6000.3 or later, check the main toolbar's customization menu: you can hide toolbar elements there, and yours might be off.

  • If the Console shows the warning Unable to retrieve cloud project data, the Editor couldn't confirm your project's Unity Cloud connection. Refer to Prerequisites, then restart the Editor after connecting.

The Scene View overlay is gone

You can hide the Collaboration overlay like any other Scene View overlay. Click inside the Scene View, press the ` key (or use the Scene View's Overlays menu), and enable Collaboration.

The overlay buttons are disabled and say "Project is not yet connected to the Cloud"

The buttons become available only after the Editor confirms your Unity Cloud project:

  1. Make sure you're signed in to the Editor with your Unity ID.
  2. Go to Edit > Project Settings > Services and link the project to a Unity Cloud project.
  3. Wait a moment. In a project that isn't connected, the check can take up to 30 seconds before it times out. After connecting, restart the Editor if the buttons stay disabled.

Seeing threads

The window says there are no threads, but my teammates created some

Work through this checklist:

  1. Mode: The source dropdown decides what you see. Scene comments appear in Active Scene mode (with that scene open); asset comments appear in Project mode.
  2. Scope: If you select an asset in the Project window, the list shows only that asset's threads. Select a folder or clear the selection to see the whole project.
  3. Filter: A Resolved/Unresolved filter can hide everything. If the placeholder offers Remove filters, select it.
  4. Cloud project: Confirm the Editor is connected to the same Unity Cloud project your teammates use (Edit > Project Settings > Services).
  5. Permissions: Confirm with your organization administrator that your role in the Unity Cloud project allows collaboration features.

I don't see any comment bubbles in the Scene View

  • Bubbles are hidden by default. Turn them on with Show comments in the Collaboration window header, the Show/Hide comment bubbles overlay button, or the toolbar button's right-click menu. Refer to Comment bubbles in the Scene View.
  • Only threads of the active scene show bubbles. Open the scene that contains the comments.
  • Asset threads never show bubbles, because they have no position in any scene.

The window shows a loading spinner and never finishes

  • Check your network connection; the thread list comes from Unity Cloud.
  • Make sure you save the active scene. An unsaved scene can't hold threads.

Creating threads

I can't create a comment in my scene

Save the scene first. Threads attach to the scene asset, so an unsaved (untitled) scene can't hold them.

The "Create new thread..." context menu entries are disabled

Both entries require exactly one selected item:

  • Comments > Create new thread for GameObject needs a single GameObject selected in a saved scene.
  • Comments > Create new thread for an asset needs exactly one item selected in the Project window. It doesn't check for folders specifically, so a single selected folder also enables it.

Nothing happens when I use the GameObject menu on a prefab

A GameObject thread needs an object in a saved scene. A prefab selected in the Project window isn't one. Comment on it as an asset instead: Comments > Create new thread for an asset.

The file picker rejects my attachment file

File attachments accept image formats only: PNG, JPG/JPEG (and the JFIF, PJP, and PJPEG variants), GIF, BMP, WEBP, SVG, AVIF, APNG, ICO, CUR.

Display issues

A comment's author shows as "Unknown User"

The Editor couldn't retrieve the author's profile. This is typically a transient network issue, or an account that has left the organization. This doesn't affect the thread itself.

A mention renders as plain text instead of a link

The mentioned object has been deleted. Mentions of objects the Editor can't currently verify (for example, in an unloaded scene) keep their stored name instead.

The collaboration icons look blurry

This issue affected early versions of this package in projects whose Quality settings apply a global texture mipmap limit (common in projects created from the 2D template). Update to the latest package version, in which quality settings don't affect the icons.

Installation issues

I can't find the package in the Package Manager

The package is experimental, so it doesn't appear in the Unity Registry view. To install it by name, refer to Installation.

Additional resources