Create a ticket

Q100081: Troubleshooting different types of Mari issues


This article describes the essential steps to follow for identifying and solving various issues in Mari.


  • Project Corruptions - If your project suddenly no longer opens and appears to be beyond retrieval then you may want to attempt to restore your project from a backup using the method described in Q100039: Restoring a Mari project from a backup.

  • Viewport glitches or issues - As most issues with the Viewport are GPU related you should always ensure you've updated your GPU driver to the latest version. If the issue persists, try Q100022: Launching Mari in safe mode as this test will temporarily reset your user preferences and customisations. If the problem still appears in safe mode check if the geometry has any shortcomings like overlapping faces, incorrect normals or topology issues.

  • Startup Crashes - Startup problems can have several causes and the most common ones are explained under Q100041: Mari launch issues.

  • Performance issues - This is directly dependent on project and setup and we recommend you to check Q100078: Mari's usage of hardware components for more information. Furthermore we recommend testing using Q100022: Launching Mari in safe mode to check if customizations or settings are causing the slowdowns.

    Additional troubleshooting suggestions for performance issues can be found here: Q100253: Troubleshooting Mari performance issues

If you are still seeing any issues after performing the steps outlined in this article, then please open a Support ticket and let us know the issue you are encountering and the troubleshooting steps you have taken so far. The information we require to investigate is outlined under Q100090: Reporting a Mari issue .
For more information on how to open a Support ticket, please refer to the 'Using the Support Portal' article.

Keywords: Mari, troubleshooting, guide, suggestions

Was this article helpful?

We're sorry to hear that!

Please tell us why.
1 out of 1 found this helpful