Attributeerror: module ‘cv2’ has no attribute ‘_registermattype’

In this article, you will discover the solution for attributeerror: module ‘cv2’ has no attribute ‘registermattype’ error message that you encounter while working with OpenCV in Python.

This error can be caused for various reasons that you may only discover here. To fix this error, you first need to understand what this error means and how to troubleshoot.

Continue to read on as we are going to show you a step-by-step guide to solving the attributeerror: module ‘cv2’ has no attribute ‘_registermattype’ error message.

What is OpenCV?

An OpenCV or (Open Source Computer Vision) is an open-source library of programming functions mainly aimed at real-time for computer vision applications for.

It provides a range of functions for image and video processing, object detection and tracking, feature detection and matching, and machine learning

What is attributeerror: module ‘cv2’ has no attribute ‘_registermattype’ error?

This attributeerror: module ‘cv2’ has no attribute ‘registermattype’ error message typically indicates that the “_registermattype” attribute is unable to be found in the “cv2” module.

It just means that the cv2 module (OpenCV library) does not have the attribute “_registermattype”. This could be caused by a variety of reasons, such as a typo in your code, an outdated version of the library, or a missing installation.

On the other hand, the attributeerror: module ‘cv2’ has no attribute ‘_registermattype’, occurs due to the incompatibility between opencv-python and opencv-python-headless.

Always remember that openCV-python-headless package is for servers, and openCV-Python is suitable for desktop applications.

And, these two should keep either the same version or be compatible with each other.

What are the causes of “attributeerror: module ‘cv2’ has no attribute ‘_registermattype'”error?

This error can occur due to various reasons, which includes:

  • 1. Outdated or incompatible version of OpenCV
  • The _registermattype attribute was introduced in OpenCV version 4.2.0. So, if you are using an older version of OpenCV, you will definitely encounter this error message.
  • 2. Incorrect installation
  • If OpenCV is not installed correctly on your system, it may not be able to find the _registermattype attribute, resulting in this error message.
  • 3. Incorrect import statement
  • If you have imported cv2 incorrectly, for instance, by typing cv instead of cv2, the Python interpreter is unable to find the _registermattype attribute, resulting in an error message.

Solutions for “attributeerror: module ‘cv2’ has no attribute ‘_registermattype'” error

Time needed: 2 minutes.

The following are effective solutions that you may use to fix the attribute error:

  1. Check OpenCV Version

    When you suspect an OpenCV version incompatibility issue, then you should first check the version of OpenCV installed on your system. You can do this by running the following command in your terminal:

    import cv2

  2. If you have an older version, you can upgrade it by running the command:

    pip install opencv-python –upgrade

    Jupyter Notebook
    !pip install opencv-python –upgrade

  3. Alternatively, if you have a newer version, you can try downgrading it by running the command:

    pip install opencv-python==

    Jupyter Notebook
    !pip install opencv-python==

    You just have to change <version_number> to the desired version.

  4. Reinstall OpenCV

    When the error persists, you can try reinstalling OpenCV on your system.
    To do this, You have to uninstall the existing OpenCV package using the following the command:


    To uninstall:
    pip uninstall opencv-python

    To install:
    pip install opencv-python

    (Jupyter Notebook)

    To uninstall:
    !pip uninstall opencv-python

    To uninstall:
    !pip install opencv-python

Additional solutions for “attributeerror: module ‘cv2’ has no attribute ‘_registermattype'”

Here are the additional solutions for the attribute error:

Solution 1

It is the easiest way to fix this error: using the pip package manager to install the module for any of the versions to match the openCV-Python version.

pip uninstall opencv-python-headless

pip install opencv-python-headless==version

Solution 2:


1. As you can see in the data above the version isn’t same. In order to fix this error, you have uninstall headless:

pip uninstall opencv-python-headless==

2. After that you have to reinstall headless with opencv-python package.

pip install opencv-python-headless==

Solution 3:

You can also solved this attribute error on Google Colab by downloading the headless open-cv and of a version below 4.3 because backward compatibility was dropped since 4.3.0. Try the following command in Google Colab:

!pip install "opencv-python-headless<4.3"

Solution 4:

Here are the following option you use to fix this attribute error:

  • Option 1 – Main modules package: pip install opencv-python
  • Option 2 – Full package (contains both main modules and contrib/extra modules): pip install opencv-contrib-python
  • Option 3 – Headless main modules without GUI package: pip install opencv-python-headless
  • Option 4 – Headless full without GUI package (contains both main modules and contrib/extra modules): pip install opencv-contrib-python-headless

Note: You don’t have to install all of it, just select one of them according to your application.

Solution 5:

You can use Conda Package Manager to fix the attribute error by installing and matching the version of the following packages:

conda install -c fastai opencv-python-headless 
conda install -c conda-forge opencv

Related Articles for Python Errors


This article provides solutions for the attributeerror: module ‘cv2’ has no attribute ‘_registermattype’, which is a big help in solving the problem you are currently facing.

Thank you very much for reading to the end of this article. Just in case you have more questions or inquiries, feel free to comment, and you can also visit our website for additional information.

Leave a Comment