As an Associate of different 3rd parties, this website earns from qualifying purchases & contains affiliate links: learn more in the footer.

Unity Bug Fixing — How to Find, Fix, and Report Issues using Unity Bug Reporter

Unity Assets

How to Fix Bugs in Unity and Solve Problems after Updating the Unity Engine to a New Version?

In this Complete Bug Fixing Tutorial, you will learn how to Approach Everyday Tasks and Where to Look for Solutions to make your project work again. You will also discover how to use the Unity Bug Reporter and Issue Tracker to properly report bugs to the Unity Team.

You can Download the Example Project here: Basketball (Unity Asset).

Unity Asset Store — Download Button

Other chapters on this page tell about separate topics that are not covered in the Video Tutorial above.

Unity Bug Reporter and Issue Tracker

When you are Facing Bugs in Unity, you need to Properly report them to the Team to get a Guaranteed Answer. Your Comments on Social Media, as well as Topics on the Discussions platform, are not enough to detect the Origin of a Bug.

Please file a Bug via Unity Bug Reporter. The Unity Issue Tracker should automatically create a New Topic on Unity Discussions when a Bug is confirmed.

For an Already Created Topic there, you can also attach the Internal Number that you will receive via Email after submitting the Bug. Only a Post with such a Number makes sense here on Discussions.

So, the chances of getting an issue fixed through the Bug Reporter are pretty high, higher than using just Unity Discissions. It’s just stats.

Case Study — Real Bug Report

During Updating My Limited FPS Shooter to Unity 6.3 LTS from Unity 2022.3, I faced 4 Bugs in Unity and AR Foundation. I was forced to use a different Color Space (Linear – default) and made some adjustments in the project to make it work now.

For All Bugs, I created Bug Reports — the crucial action in Development because bugs can be relevant only for your project and exist for years.

At the same time, creating the bug report can require a significant amount of time (several hours).

Bugs are not reasons to pause project development, there is almost always another way to achieve the goal. 1 Bug out of 4 is already fixed by Unity — Thank You!

Unity Issue Tracker — Bug Report

These bugs are not affecting the project, but they are existing in Unity. In addition to Creating Bug Reports in Unity Issue Tracker, I also composed detailed posts on Unity Discussions to get more attention to the bugs:

  1. Unity AR Foundation/ARCore/OpenGLES3 Bug: Texture must have width greater than 0; Exception: Failed to create texture because of invalid parameters.
  2. Enabling Image Stabilization causes Blinking on Android (AR Foundation: ARCore).
  3. Unity AR Foundation/ARCore/Vulkan Bug: Gamma Color Space affects AR Camera Background (Feed from Device Camera is too Bright).
  4. Android Build is Closed at the very first launch after installing using Development Mode.

Unity’s Jira & Bug Fixing: How to Add Info to Bug Report

Unity uses Jira for Bug Reporting and Issue Tracking.

There is one amazing thing here: you can have a static chat with a QA Engineer that can request additional info about your issue, and you can attach any file.

Email notifications work, and the whole process has been improved over the years: you will be notified about every update in your report.

Unity's Jira: How to Add Additional Info to Bug Report — Bug Fixing

Unity Bug Report Status — “Won’t Fix” Explanation

The “Won’t Fix” status exists because engineering teams (obviously) have finite resources and a constant stream of incoming bug reports. The Unity Team noticed that certain kinds of bugs never made it to the top of the pile because there was always something higher-priority ahead of them.

So they decided to start marking those bugs as “Won’t Fix” to be transparent about the fact that they didn’t expect to address them. However, the downside is that developers put real effort into submitting bug reports, only to see them closed with a “Won’t Fix” status, which can feel discouraging.

It’s a difficult balance to strike, and the Unity Team acknowledges that there may not be a perfect solution, but remains open to suggestions.

I’ve always preferred constructive dialogue, bug reports, and meaningful communication with Unity employees on LinkedIn and on Unity Discussions. I believe that’s the approach that actually leads to solving problems and implementing new features. And as you can see from the screenshots of comments under my public post, this approach literally works:

  • No Drama.
  • No Hate Speech.
  • Just Respectful Conversation.

Indie Developers and Companies, it’s in your hands to make the Unity ecosystem better by contributing to bug fixing. We’re all working toward the same bigger goal, I believe, and improving the tools we use, like Unity, Unreal, and Godot, is definitely not just the responsibility of the companies behind them. Developers’ efforts matter.

Unity Assets by Makaka Games

Andrey Sirota

I'm the Founder of Makaka Games, and I Share Developer Tips and Tutorials on My Social Media: Open to Brand Collaborations and Product Promotion.
Back to top button