Troubleshooting Unity Studio issues
Troubleshoot common issues and solutions for Unity Studio.
読み終わるまでの所要時間 6 分最終更新 4日前
When you open a draft, a blank scene appears
It might take a few seconds for your draft to load, especially if your project is large or your internet connection is slow. It's recommended to wait at least one minute before closing the tab or trying to reload the page. If after a minute your scene is still empty, something might be broken. In that case, try recovering a previously saved version of your draft from the Asset Manager. For more information, refer to Recover previous draft versions.When you open the home screen, an error message appears
You might encounter an error message similar to this when you access Unity Studio:- You don't have the correct roles to create a project in the selected organization. Please contact the organization administrator.
- Join an external organization: Make sure you have the correct permissions to upload, download, or create projects. The organization owner or admin needs to grant you these permissions. There are default permissions based on your role, but admins can adjust them for each project.
- Join an Industry organization: You need to have an industry seat assigned to your account to collaborate in that organization.
When you create a project, an error message appears
You might encounter an error message similar to this when you create a project on the Create Draft screen:- You don't have the correct roles to create a project in the selected organization. Please contact the organization Administrator.
- Public Cloud: You must have the Owner or Manager role to create a project.
- Self-Hosted Deployment: You must be either:
- the organization Owner, or
- a user with the Asset Manager Admin role for the Asset Manager
You encounter performance issues
If you encounter performance issues with Unity Studio, try the following methods:- Check that your browser supports WebGPU
- Ensure the browser uses your discrete GPU
- Enable graphics or hardware acceleration
Check that your browser supports WebGPU
Unity Studio requires browsers that support WebGPU. For optimum experience, use the desktop version of Google Chrome or Microsoft Edge to access Unity Studio. The following are the most common browsers that support WebGPU:Browser | Version |
|---|---|
| Google Chrome | WebGPU is enabled by default in Chrome version 113+. |
| Microsoft Edge | WebGPU is enabled by default in 113+. |
| Safari | Safari 17+ (latest version) on macOS and iOS/iPadOS. |
| Firefox | To enable WebGPU in Firefox, use Firefox Nightly and then set dom.webgpu.enabled to true. |
注
Unity Studio isn't supported on mobile browsers yet. Follow this step-by-step guide to check if your browser supports WebGPU:
- Open Unity Studio in your browser.
- Open the Developer Console:
- On Chrome: press Ctrl+Shift+J (Windows/Linux) or Cmd+Option+J (macOS), or go to Menu (⋮) > More Tools > Developer Tools > Console.
- On Edge: press Ctrl+Shift+J (Windows) or Cmd+Option+J (macOS), or Menu (⋯) > More Tools > Developer Tools > Console.
- On Firefox: press Ctrl+Shift+K (Windows/Linux) or Cmd+Option+K (macOS), or Menu (≡) > More Tools > Web Developer Tools > Console.
- In the console input at the bottom, enter: .
navigator.gpu - Press Enter.
- Interpret the result:
- If it prints or an object, WebGPU is available.
GPU (…) - If it prints , WebGPU isn't available in this browser/context.
undefined - If an error message appears to inform you that the navigator isn't defined, make sure the Console is focused on the page (not on a background frame) and reload the page.
Follow this step-by-step guide to check if your version of Safari supports WebGPU:
- Go to Safari > Settings > Advanced.
- Enable Show Develop menu in menu bar.
- Open the page where Unity Studio runs.
- Open the Web Inspector Console and do one of the following:
- Go to Develop > Show Web Inspector, then select the Console tab.
- Press Option+Cmd+C.
- In the console, type and press Enter.
navigator.gpu - Interpret the result:
- If it returns an object or value, WebGPU is available.
- If it returns , WebGPU isn't available.
undefined
ヒント
If exists but Unity Studio still doesn’t run well, run .
If the console logs a GPU name, WebGPU is active. If the console logs or errors, the feature might be blocked by settings, drivers, or policies.
navigator.gpunavigator.gpu.requestAdapter()No adapterEnsure the browser uses your discrete GPU
If Unity Studio doesn't run properly in your browser, try setting your browser to use your discrete GPU instead of integrated graphics.Disable system power saving
- Open Settings > System > Power & battery.
- Under Power Mode, choose Best Performance (or Balanced if Best Performance is unavailable).
Force the browser to use the high‑performance GPU
- Go to Settings > System > Display > Graphics.
- Go to Custom settings for applications.
- Use the search bar to search for your browser application. If the search returns nothing, select Add desktop app and add your browser:
- Chrome:
C:\Program_ Files\Google\Chrome\Application\chrome.exe - Edge:
C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe - Firefox:
C:\Program Files\Mozilla Firefox\firefox.exe
- Select the added browser, then set GPU preference to High Performance.
Configure settings in the NVIDIA Control Panel
- Open NVIDIA Control Panel.
- Select Manage 3D settings.
- Select the Program Settings tab.
- Set option 1 to your browser application.
- Set option 2 to High‑performance NVIDIA processor.
- Select Apply.
Configure settings in the Intel Graphics Command Center
- Open the Intel Graphics Command Center.
- Select System > Power > On Battery > Power Plans.
- Set to Maximum Performance.
For laptops with automatic graphics switching:
- Go to System Settings > Battery.
- Disable Automatic graphics switching (forces discrete GPU when plugged in).
注
For Apple Silicon MacBooks, this setting doesn’t exist. The system manages GPU selection automatically.
ヒント
Keep the device's power adapter connected and set Battery settings to High Power mode where available (on supported MacBook Pro models).
Enable graphics or hardware acceleration
If Unity Studio has performance issues, it might help to enable graphics or hardware acceleration.- Go to Menu (⋮) > Settings > System.
- Enable Use graphics acceleration when available.
- Relaunch Chrome.
- Go to Menu (⋯) > Settings > System and performance > Graphics acceleration.
- Enable Use graphics acceleration when available.
- Relaunch Edge.
- Go to Menu (≡) > Settings > General.
- Performance: Disable Use recommended performance settings and enable Use hardware acceleration when available.
- Relaunch Firefox.
Hardware acceleration is enabled by default and you can’t deactivate it.
Unity Studio stalls at 100% during loading
If Unity Studio stalls at 100% during loading, try the following methods to fix this issue:- Toggle hardware or graphics acceleration
- Fully restart the browser
- Clear website data only
- Disable extensions temporarily
- Update your browser and GPU drivers
Toggle hardware or graphics acceleration
- Deactivate graphics or hardware acceleration. To find this setting for your browser, refer to Enable graphics acceleration.
- Fully quit the browser and then re-open.
- Re-activate graphics/hardware acceleration.
- Fully quit the browser and reopen again.
Fully restart the browser
Close all windows and ensure the process exits (use Task Manager on Windows or quit from the Dock on macOS).Clear website data only
Clear the website's cookies and data to possibly fix the stalling issue. Avoid clearing the full history of the browser.With Unity Studio open, do one of the following:
-
Erase cookies from View site information menu:
- Select View site information (the tune or lock icon in the browser searchbar).
- Go to Site settings > Delete data.
-
Erase cookies from the Settings menu:
- Go to Menu > Settings > Privacy and security > Third-party cookies.
- Select See all site data and permission.
- Find and expand in the list of websites.
unity.com - Select .
cloud.unity.com - Select Delete data.
With Unity Studio open, do one of the following:
-
Erase cookies from View site information menu:
- Select View site information (the lock icon in the browser searchbar).
- go to Cookies and site data > Cookies.
- In the list of websites expand .
https://cloud.unity.com - Select Cookies then select Remove.
-
Erase cookies from the Settings menu:
- Go to Settings > Privacy, search and services > Cookies.
- Select See all cookies and site data.
- In the list of websites, search for and expand .
unity.com - Select , and then click Delete.
cloud.unity.com
With Unity Studio open, do one of the following:
-
Erase cookies from the Site information menu:
- Select Site information (the lock icon in the browser searchbar).
- Go to Clear cookies and site data.
- Select Remove.
-
Erase cookies from the Settings menu:
- Go to Settings > Privacy & Security > Cookies and Site Data > Manage browsing data.
- In the list of websites, select .
cloud.unity.com - Select Remove Selected.
- Select Save Changes.
In the Menu:
- Go to Safari Settings > Privacy > Manage Website Data.
- Search for the website’s domain.
- Select the matching entries and then click Remove > Done.
- Reload the website.
Disable extensions temporarily
Test Unity Studio in an Incognito/Private window with all extensions disabled.Update your browser and GPU drivers
Make sure your browser and GPU drivers are up-to-date to prevent performance issues.On Windows
- Open Windows Update (Go to Start > Settings > Windows Updates).
- Select Check for updates. If the process returns that you're not up-to-date, follow the process to update Windows.
- Install the latest NVIDIA, AMD, and Intel drivers.
On macOS
Update macOS to the latest point release.Undefined error on Chrome
If you get anerror: undefined- Select inside the Chrome window and press Ctrl+Shift+Del (macOS: Cmd+Shift+Delete). The Delete browsing data window appears and shows the data you can choose to delete.
- Select More > All time.
- Enable Cached images and files. You can also specify other data types to delete but it's not required.
- Select Delete data. Chrome deletes all cached files.
- Reopen Unity Studio.