attributeerror module ‘collections’ has no attribute ‘mutablemapping’

In this post, we will discuss the solution on how to solve the attributeerror: module collections has no attribute mutablemapping.

The error message “AttributeError: module ‘collections’ has no attribute ‘MutableMapping’” shows that the collections module in Python doesn’t have an attribute named MutableMapping.

What is a mutablemapping in Python?

The MutableMapping is an abstract base class in the Python programming language’s collections module.

It specifies a common interface for mapping objects, such as dictionaries, that can be modified after they are created.

Why the attributeerror: module ‘collections’ has no attribute ‘mutablemapping’ occur?

The attributeerror: module ‘collections’ has no attribute ‘mutablemapping’ error usually occurs because of internal code changes in the 3.10 version.

When you are using any syntax similar to the collections module that is compatible with the 3.9 version over the python 3.10-based python environment, you will get this error.

Also, you might interested to read or visit the other related error resolved:

How to solve the attributeerror: module collections has no attribute mutablemapping?

Time needed: 3 minutes

Here are the solutions to solve the attributeerror: module collections has no attribute mutablemapping. You can choose one of the solutions below that fits to your problem.

  • Solution 1: Downgrade the python version to 3.9 version or below

    All that was required to install the lower version successfully and it will change it to the older Python version.

    This means you don’t have to easily uninstall the current Python version.

    download python 3.9 for attributeerror module 'collections' has no attribute 'mutablemapping'

  • Solution 2: Modify the import statement

    For real, the internal framework has been changed in the 3.10 version.

    Therefore, you have to use two different methods for importing this mutablemapping module.

    The following are the syntax code differences.

    For version 3.10+:

    from import MutableMapping

    For version 3.9 or below:

    from collections import MutableMapping

    If you want this environment perfectly effective then you can call the below code.

    import collections
    if sys.version_info.major == 3 and sys.version_info.minor >= 10
    from import MutableMapping
    from collections import MutableMapping

    The above code will verify the latest Python major and minor versions.

    With the support of the available configuration, then it will change with the correct syntax.

    This is a typical way to generate code that is version independent.

  • Solution 3: Upgrade all related module

    In some situations, For upgrading the setup module along with the requests module, can resolve this error.

    However, if the above two haven’t resolved the error successfully then you must try this set of commands.

    After this, you need to try again the solution 2.

    pip install --upgrade pip
    pip install --upgrade wheel
    pip install --upgrade setuptools
    pip install --upgrade requests

Here’s an example of how to use UserDict.MutableMapping:

from collections import UserDict

class MyMapping(UserDict.MutableMapping):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)

    def __setitem__(self, key, value):
        super().__setitem__(key, value)

    def __delitem__(self, key):

    def __getitem__(self, key):
        return super().__getitem__(key)

    def __iter__(self):
        return super().__iter__()

    def __len__(self):
        return super().__len__()


To conclude, the error message “module ‘collections’ has no attribute ‘MutableMapping’” usually occurs when you are trying to use the MutableMapping abstract base class from the collections module.

Yet your Python version does not support it. In such situation, you can use the UserDict.MutableMapping class instead to make a mapping class that operate like a mutable mapping.

You should remember always that you need to implement the required methods (__setitem__, __delitem__, __getitem__, __iter__, and __len__) in your class for make it a valid mutable mapping.

Leave a Comment