matplotlib · dikshajangra12918-oss · Apr 21, 2026 · Apr 21, 2026 · Apr 22, 2026 · Apr 22, 2026
diff --git a/lib/matplotlib/scale.py b/lib/matplotlib/scale.py
@@ -956,6 +956,25 @@ def register_scale(scale_class):
         )
 
 
+def unregister_scale(name):
+    """
+    Remove a custom scale from the registry.
+
+    Parameters
+    ----------
+    name : str
+        The name of the scale to remove.
+    """
+    _builtin_scales = {'linear', 'log', 'symlog', 'logit',
 if name in self._builtin_cmaps: 
     raise ValueError(f"cannot unregister {name!r} which is a builtin " 
                      "colormap.") 
 if name in self._builtin_cmaps: 
     raise ValueError(f"cannot unregister {name!r} which is a builtin " 
                      "colormap.") 
+                       'asinh', 'function', 'functionlog'}
+    if name in _builtin_scales:
+        raise ValueError(
+            f"Cannot unregister built-in scale {name!r}.")
+    if name not in _scale_mapping:
+        raise ValueError(f"Scale '{name}' is not registered.")
+    del _scale_mapping[name]
+
+
 def _get_scale_docs():
     """
     Helper function for generating docstrings related to scales.

diff --git a/lib/matplotlib/scale.pyi b/lib/matplotlib/scale.pyi
@@ -182,4 +182,5 @@ class LogitScale(ScaleBase):
 def get_scale_names() -> list[str]: ...
 def scale_factory(scale: str, axis: Axis, **kwargs) -> ScaleBase: ...
 def register_scale(scale_class: type[ScaleBase]) -> None: ...
+def unregister_scale(name: str) -> None: ...
 def _make_axis_parameter_optional(init_func: Callable[..., None]) -> Callable[..., None]: ...
diff --git a/lib/matplotlib/tests/test_scale.py b/lib/matplotlib/tests/test_scale.py
@@ -330,9 +330,7 @@ def set_default_locators_and_formatters(self, axis):
         ax.set_xscale('custom')
         assert isinstance(ax.xaxis.get_transform(), CustomTransform)
     finally:
-        # cleanup - there's no public unregister_scale()
-        del mscale._scale_mapping["custom"]
-        del mscale._scale_has_axis_parameter["custom"]
+        mscale.unregister_scale("custom")
 
 
 def test_custom_scale_with_axis():
@@ -368,9 +366,7 @@ def set_default_locators_and_formatters(self, axis):
         ax.set_xscale('custom')
         assert isinstance(ax.xaxis.get_transform(), CustomTransform)
     finally:
-        # cleanup - there's no public unregister_scale()
-        del mscale._scale_mapping["custom"]
-        del mscale._scale_has_axis_parameter["custom"]
+        mscale.unregister_scale("custom")
 
 
 def test_val_in_range():
@@ -433,3 +429,40 @@ def test_val_in_range_base_fallback():
     assert s.val_in_range(np.nan) is False
     assert s.val_in_range(np.inf) is False
     assert s.val_in_range(-np.inf) is False
+
+
+def test_unregister_scale():
+    """Test that unregister_scale removes a scale correctly."""
+    # Register a temporary custom scale
+    class TempScale(mscale.ScaleBase):
+        name = 'temp_test_scale'
+
+        def __init__(self):
+            pass
+
+        def get_transform(self):
+                from matplotlib.transforms import IdentityTransform
+                return IdentityTransform()
+
+        def set_default_locators_and_formatters(
+                self, axis):
+            pass
+
+    mscale.register_scale(TempScale)
+    assert 'temp_test_scale' in mscale._scale_mapping
+
+    # Now unregister it
+    mscale.unregister_scale('temp_test_scale')
+    assert 'temp_test_scale' not in mscale._scale_mapping
+
+
+def test_unregister_scale_invalid():
+    """Test that unregister_scale raises ValueError for unknown scale."""
+    with pytest.raises(ValueError, match="not registered"):
+        mscale.unregister_scale('this_does_not_exist')
+
+
+def test_unregister_scale_builtin():
+    """Test that built-in scales cannot be unregistered."""
+    with pytest.raises(ValueError, match="Cannot unregister built-in scale"):
+        mscale.unregister_scale('log')