<html lang="en" data-content_root="../" >

<head>

<meta charset="utf-8" />

<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />

<title>All tags: component: legend &#8212; Matplotlib 3.11.2 documentation</title>

<script data-cfasync="false">

document.documentElement.dataset.mode = localStorage.getItem("mode") || "";

document.documentElement.dataset.theme = localStorage.getItem("theme") || "";

</script>

<!--

<noscript>

<style>

.pst-js-only { display: none !important; }

</style>

</noscript>

<!-- Loaded before other Sphinx assets -->

<link href="../_static/styles/theme.css?digest=8878045cc6db502f8baf" rel="stylesheet" />

<link href="../_static/styles/pydata-sphinx-theme.css?digest=8878045cc6db502f8baf" rel="stylesheet" />

<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=03e43079" />

<link rel="stylesheet" type="text/css" href="../_static/css/style.css?v=522e7f4d" />

<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=4ae1632d" />

<link rel="stylesheet" type="text/css" href="../_static/plot_directive.css" />

<link rel="stylesheet" type="text/css" href="../_static/copybutton.css?v=76b2166b" />

<link rel="stylesheet" type="text/css" href="../_static/sg_gallery.css?v=fd6457a4" />

<link rel="stylesheet" type="text/css" href="../_static/sg_gallery-binder.css?v=f4aeca0c" />

<link rel="stylesheet" type="text/css" href="../_static/sg_gallery-dataframe.css?v=2082cf3c" />

<link rel="stylesheet" type="text/css" href="../_static/sg_gallery-rendered-html.css?v=1277b6f3" />

<link rel="stylesheet" type="text/css" href="../_static/sphinx-design.min.css?v=95c83b7e" />

<link rel="stylesheet" type="text/css" href="../_static/mpl.css?v=5a7e13c8" />

<!-- So that users can add custom icons -->

<script src="../_static/scripts/fontawesome.js?digest=8878045cc6db502f8baf"></script>

<!-- Pre-loaded scripts that we'll load fully later -->

<link rel="preload" as="script" href="../_static/scripts/bootstrap.js?digest=8878045cc6db502f8baf" />

<link rel="preload" as="script" href="../_static/scripts/pydata-sphinx-theme.js?digest=8878045cc6db502f8baf" />

<script src="../_static/documentation_options.js?v=1a85da86"></script>

<script src="../_static/doctools.js?v=fd6eb6e6"></script>

<script src="../_static/sphinx_highlight.js?v=6ffebe34"></script>

<script src="../_static/sg-tags.js?v=d80f6fa4"></script>

<script src="../_static/clipboard.min.js?v=a7894cd8"></script>

<script src="../_static/copybutton.js?v=ccdb6887"></script>

<script src="../_static/design-tabs.js?v=f930bc37"></script>

<script data-domain="matplotlib.org" defer="defer" src="https://views.scientific-python.org/js/script.js"></script>

<script>DOCUMENTATION_OPTIONS.pagename = '_tags/component-legend';</script>

<script>

DOCUMENTATION_OPTIONS.theme_version = '0.16.1';

DOCUMENTATION_OPTIONS.theme_switcher_json_url = 'https://matplotlib.org/devdocs/_static/switcher.json?v3.11.2-1-g879ad8ebba';

DOCUMENTATION_OPTIONS.theme_switcher_version_match = '3.11.2';

DOCUMENTATION_OPTIONS.show_version_warning_banner =

true;

</script>

<link rel="canonical" href="https://matplotlib.org/stable/_tags/component-legend.html" />

<link rel="search" type="application/opensearchdescription+xml"

title="Search within Matplotlib 3.11.2 documentation"

href="../_static/opensearch.xml"/>

<link rel="icon" href="../_static/favicon.ico"/>

<link rel="search" title="Search" href="../search.html" />

<meta name="viewport" content="width=device-width, initial-scale=1"/>

<meta name="docsearch:language" content="en"/>

<meta name="docsearch:version" content="3.11.2" />

<meta name="docbuild:last-update" content="Sep 11, 2026"/>

</head>

<body data-bs-spy="scroll" data-bs-target=".bd-toc-nav" data-offset="180" data-bs-root-margin="0px 0px -60%" data-default-mode="">

<div id="pst-skip-link" class="skip-link d-print-none"><a href="#main-content">Skip to main content</a></div>

<div id="pst-scroll-pixel-helper"></div>

<button type="button" class="btn rounded-pill" id="pst-back-to-top">

<i class="fa-solid fa-arrow-up"></i>Back to top</button>

<dialog id="pst-search-dialog">

<form class="bd-search d-flex align-items-center"

action="../search.html"

method="get">

<i class="fa-solid fa-magnifying-glass"></i>

<input type="search"

class="form-control"

name="q"

placeholder="Search the docs ..."

aria-label="Search the docs ..."

autocomplete="off"

autocorrect="off"

autocapitalize="off"

spellcheck="false"/>

<span class="search-button__kbd-shortcut"><kbd class="kbd-shortcut__modifier">Ctrl</kbd>+<kbd>K</kbd></span>

</dialog>

<div class="pst-async-banner-revealer d-none">

<aside id="bd-header-version-warning" class="d-none d-print-none" aria-label="Version warning"></aside>

<header class="bd-header navbar navbar-expand-lg bd-navbar d-print-none">

<div class="bd-header__inner bd-page-width">

<button class="pst-navbar-icon sidebar-toggle primary-toggle" aria-label="Site navigation">

<span class="fa-solid fa-bars"></span>

</button>

<div class="col-lg-3 navbar-header-items__start">

<div class="navbar-item">

<a class="navbar-brand logo" href="https://matplotlib.org/stable/">

<img src="../_static/logo_light.svg" class="logo__image only-light" alt="Matplotlib 3.11.2 documentation - Home"/>

<img src="../_static/logo_dark.svg" class="logo__image only-dark pst-js-only" alt="Matplotlib 3.11.2 documentation - Home"/>

</div>

<div class="col-lg-9 navbar-header-items">

<div class="me-auto navbar-header-items__center">

<div class="navbar-item"><ul id="navbar-main-elements" class="navbar-nav">

<li class="nav-item">

<a class="reference internal nav-link" href="../plot_types/index.html">Plot types</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../users/index.html">User guide</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../tutorials/index.html">Tutorials</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../gallery/index.html">Examples</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../api/index.html">Reference</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../devel/index.html">Contribute</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../users/release_notes.html">Releases</a>

</li>

</div>

<div class="navbar-header-items__end">

<div class="navbar-item navbar-persistent--container">

<button class="btn btn-sm pst-navbar-icon search-button search-button__button pst-js-only" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">

<i class="fa-solid fa-magnifying-glass fa-lg"></i>

</div>

<div class="navbar-item">

<button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button pst-js-only" aria-label="Color mode" data-bs-title="Color mode" data-bs-placement="bottom" data-bs-toggle="tooltip">

<i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light" title="Light"></i>

<i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark" title="Dark"></i>

<i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto" title="System Settings"></i>

<div class="navbar-item">

<div class="version-switcher__container dropdown pst-js-only">

<button id="pst-version-switcher-button-2"

type="button"

class="version-switcher__button btn btn-sm dropdown-toggle"

data-bs-toggle="dropdown"

aria-haspopup="listbox"

aria-controls="pst-version-switcher-list-2"

aria-label="Version switcher list"

>

Choose version <!-- this text may get changed later by javascript -->

<span class="caret"></span>

</button>

<div id="pst-version-switcher-list-2"

class="version-switcher__menu dropdown-menu list-group-flush py-0"

role="listbox" aria-labelledby="pst-version-switcher-button-2">

<!-- dropdown will be populated by javascript on page load -->

</div>

<div class="navbar-item"><ul class="navbar-icon-links"

aria-label="Icon Links">

<li class="nav-item">

<a href="https://gitter.im/matplotlib/matplotlib" title="Gitter" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-brands fa-gitter fa-lg" aria-hidden="true"></i>

<span class="sr-only">Gitter</span></a>

</li>

<li class="nav-item">

<a href="https://discourse.matplotlib.org" title="Discourse" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-brands fa-discourse fa-lg" aria-hidden="true"></i>

<span class="sr-only">Discourse</span></a>

</li>

<li class="nav-item">

<a href="https://github.com/matplotlib/matplotlib" title="GitHub" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-brands fa-github fa-lg" aria-hidden="true"></i>

<span class="sr-only">GitHub</span></a>

</li>

</div>

</div>

<div class="navbar-persistent--mobile">

<button class="btn btn-sm pst-navbar-icon search-button search-button__button pst-js-only" title="Search" aria-label="Search" data-bs-placement="bottom" data-bs-toggle="tooltip">

<i class="fa-solid fa-magnifying-glass fa-lg"></i>

</div>

</header>

<div class="bd-container">

<div class="bd-container__inner bd-page-width">

<dialog id="pst-primary-sidebar-modal"></dialog>

<div id="pst-primary-sidebar" class="bd-sidebar-primary bd-sidebar">

<div class="sidebar-header-items sidebar-primary__section">

<div class="sidebar-header-items__center">

<div class="navbar-item"><ul id="navbar-main-elements" class="navbar-nav">

<li class="nav-item">

<a class="reference internal nav-link" href="../plot_types/index.html">Plot types</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../users/index.html">User guide</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../tutorials/index.html">Tutorials</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../gallery/index.html">Examples</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../api/index.html">Reference</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../devel/index.html">Contribute</a>

</li>

<li class="nav-item">

<a class="reference internal nav-link" href="../users/release_notes.html">Releases</a>

</li>

</div>

<div class="sidebar-header-items__end">

<div class="navbar-item">

<button class="btn btn-sm nav-link pst-navbar-icon theme-switch-button pst-js-only" aria-label="Color mode" data-bs-title="Color mode" data-bs-placement="bottom" data-bs-toggle="tooltip">

<i class="theme-switch fa-solid fa-sun fa-lg" data-mode="light" title="Light"></i>

<i class="theme-switch fa-solid fa-moon fa-lg" data-mode="dark" title="Dark"></i>

<i class="theme-switch fa-solid fa-circle-half-stroke fa-lg" data-mode="auto" title="System Settings"></i>

<div class="navbar-item">

<div class="version-switcher__container dropdown pst-js-only">

<button id="pst-version-switcher-button-3"

type="button"

class="version-switcher__button btn btn-sm dropdown-toggle"

data-bs-toggle="dropdown"

aria-haspopup="listbox"

aria-controls="pst-version-switcher-list-3"

aria-label="Version switcher list"

>

Choose version <!-- this text may get changed later by javascript -->

<span class="caret"></span>

</button>

<div id="pst-version-switcher-list-3"

class="version-switcher__menu dropdown-menu list-group-flush py-0"

role="listbox" aria-labelledby="pst-version-switcher-button-3">

<!-- dropdown will be populated by javascript on page load -->

</div>

<div class="navbar-item"><ul class="navbar-icon-links"

aria-label="Icon Links">

<li class="nav-item">

<a href="https://gitter.im/matplotlib/matplotlib" title="Gitter" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-brands fa-gitter fa-lg" aria-hidden="true"></i>

<span class="sr-only">Gitter</span></a>

</li>

<li class="nav-item">

<a href="https://discourse.matplotlib.org" title="Discourse" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-brands fa-discourse fa-lg" aria-hidden="true"></i>

<span class="sr-only">Discourse</span></a>

</li>

<li class="nav-item">

<a href="https://github.com/matplotlib/matplotlib" title="GitHub" class="nav-link pst-navbar-icon" rel="noopener" target="_blank" data-bs-toggle="tooltip" data-bs-placement="bottom"><i class="fa-brands fa-github fa-lg" aria-hidden="true"></i>

<span class="sr-only">GitHub</span></a>

</li>

</div>

</div>

<div class="sidebar-primary-items__start sidebar-primary__section">

<div class="sidebar-primary-item">

<nav class="bd-docs-nav bd-links"

aria-label="Section Navigation">

<p class="bd-links__title" role="heading" aria-level="1">Section Navigation</p>

<div class="bd-toc-item navbar-nav"><p aria-level="2" class="caption" role="heading"><span class="caption-text">With this tag</span></p>

<ul class="nav bd-sidenav">

<li class="toctree-l1"><a class="reference internal" href="../gallery/lines_bars_and_markers/scatter_with_legend.html">Scatter plot with a legend</a></li>

<li class="toctree-l1"><a class="reference internal" href="../gallery/pie_and_polar_charts/polar_legend.html">Polar legend</a></li>

</div>

<div class="sidebar-primary-items__end sidebar-primary__section">

<div class="sidebar-primary-item">

<div id="ethical-ad-placement"

class="flat"

data-ea-publisher="readthedocs"

data-ea-type="readthedocs-sidebar"

data-ea-manual="true">

</div>

</div>

<main id="main-content" class="bd-main" role="main">

<div class="bd-content">

<div class="bd-article-container">

<div class="bd-header-article d-print-none">

<div class="header-article-items header-article__inner">

<div class="header-article-items__start">

<div class="header-article-item">

<nav aria-label="Breadcrumb" class="d-print-none">

<ul class="bd-breadcrumbs">

<li class="breadcrumb-item breadcrumb-home">

<a href="../index.html" class="nav-link" aria-label="Home">

<i class="fa-solid fa-home"></i>

</a>

</li>

<li class="breadcrumb-item active" aria-current="page"><span class="ellipsis">All tags: component: legend</span></li>

</ul>

</div>

<div id="searchbox"></div>

<article class="bd-article">

<section id="all-tags-component-legend">

<span id="sphx-tag-component-legend"></span><h1>All tags: component: legend<a class="headerlink" href="#all-tags-component-legend" title="Link to this heading">#</a></h1>

<div class="toctree-wrapper compound">

<p aria-level="2" class="caption" role="heading"><span class="caption-text">With this tag</span></p>

<li class="toctree-l1"><a class="reference internal" href="../gallery/lines_bars_and_markers/scatter_with_legend.html">Scatter plot with a legend</a></li>

<li class="toctree-l1"><a class="reference internal" href="../gallery/pie_and_polar_charts/polar_legend.html">Polar legend</a></li>

</article>

</div>

</div>

<footer class="bd-footer-content">

</footer>

</main>

</div>

</div>

<!-- Scripts loaded after <body> so the DOM is not blocked -->

<script defer src="../_static/scripts/bootstrap.js?digest=8878045cc6db502f8baf"></script>

<script defer src="../_static/scripts/pydata-sphinx-theme.js?digest=8878045cc6db502f8baf"></script>

<footer class="bd-footer">

<div class="bd-footer__inner bd-page-width">

<div class="footer-items__start">

<div class="footer-item">

<p class="copyright">

© Copyright 2002–2012 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the Matplotlib development team; 2012–2026 The Matplotlib development team.

<br/>

</p>

<div class="footer-item">

<p class="sphinx-version">

Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 9.1.0.

<br/>

</p>

<div class="footer-item">

<p class="sphinx-version">

Built from v3.11.2-1-g879ad8ebba.

<br/>

</p>

</div>

<div class="footer-items__end">

<div class="footer-item">

<p class="theme-version">

<!-- # L10n: Setting the PST URL as an argument as this does not need to be localized -->

Built with the <a href="https://pydata-sphinx-theme.readthedocs.io/en/stable/index.html">PyData Sphinx Theme</a> 0.16.1.

</div>

</footer>

</body>