How to Report a Bug

A bug is a defect in the engine code which results in an unexpected behavior, and can be reproduced under specific conditions.  If you believe that you have discovered a bug in the Unreal Engine 4, please follow the steps below.  

Please be aware that the purpose behind reporting bugs is so any issues can be fixed in future updates. Epic does not provide custom engineering work or troubleshooting for general development challenges. Thank you for helping to improve the Unreal Engine!

Before you Report

  • Take a moment to evaluate whether it is an engine bug or not. Are you using the feature as intended? Do you know the expected result?  Have you modified any code that may break the feature? Are you using any 3rd-party Plugins? Are you using supported hardware and software?
  • Search the Unreal Engine Issues site, or the Answerhub, to see if the issue is already known and reported.
  • Reproduce the issue again.  Does it still occur?  Do you know the steps? Can you simplify the steps? Can you make it occur on a new project?
  • If you experience a crash, make sure you submit the Crash Report with additional information about what you were doing when the crash occurred. 
  • Gather all information. What engine version are you using? What is your operating system? What are your system specifications? Do you have your project logs ({projectname}/Saved/Logs)? Have you taken screenshots?

 

Remember: If Epic staff cannot reproduce and experience the issue, then they probably cannot fix it either.

 

Make the Report

If you have all of the information that Epic will need to reproduce and investigate the issue, you can write the bug report by going to the UE4 Answerhub and clicking "Post A Question", or just Click Here. If you have a Custom license agreement, please post your bug report to the UDN instead. Follow these steps when writing the report:

  • Give it a concise but detailed title, such as "Crash on OSX 10.11 when editing blueprint variables"
  • Post it to the 'Bug Reports' section
  • From the Product Version dropdown list, select the version of the Unreal Engine that you are using 
  • In the body of the message, provide any relevant information about your system or project. Write a thorough description of the issue.  List out the reproduction steps to cause the issue. 
  • Upload any important attachments such as log files, screenshots, videos, or assets.
  • Give it the tag of "bug report" along with any others that are relevant

 

After you Report

  • Epic support staff will investigate your report as soon as possible. Please be patient and do not "bump" the post.
  • Be sure to check back on the report, because Epic support staff may have additional questions for you.
  • If your issue cannot be reproduced by Epic staff, then the report may be closed, and it is up to you to provide additional information so staff can continue the investigation.
  • If your issue is reproduced, Epic will create a bug report on their internal system and provide you with an ID number or a link to the report.
  • At this point, Epic staff will mark your Answerhub post as "Resolved"; this does not mean that the bug has been fixed, but that your report is complete.
  • You can follow the status of the bug on the Unreal Engine Issues site.

 

Confirmed bugs may or may not be fixed quickly, depending on the severity of the issue, how many users it impacts, and Epic's current priorities for engine development.