Altcademy - a Forbes magazine logo Best Coding Bootcamp 2023

How to add a legend in matplotlib

Understanding Legends in Data Visualization

Before we dive into the practical steps of adding a legend to a plot in matplotlib, let's first understand what a legend is and why it's important. In the simplest terms, a legend is a guide for a chart or graph that explains what each symbol, color, or line style represents. Imagine you're looking at a treasure map; the legend is the part that tells you what each symbol means, like where the treasure is or where to find the dreaded pirate traps!

In data visualization, a legend serves a similar purpose. It helps the viewer distinguish between different data sets or categories within a single plot. Without a legend, someone looking at your graph might see a bunch of lines or bars and have no idea what each one stands for. The legend is the key that unlocks the meaning behind these visual elements.

Starting with a Simple Plot

To illustrate how to add a legend, let's start with a simple example. We'll create a basic line plot with matplotlib, a popular plotting library in Python. Here's a step-by-step guide to creating your first plot:

import matplotlib.pyplot as plt

# Sample data
x = [1, 2, 3, 4]
y = [10, 20, 25, 30]

# Create a figure and an axis
fig, ax = plt.subplots()

# Plotting the data
ax.plot(x, y, label='My Data')

# Display the plot

In this code, we import the matplotlib.pyplot module, which is commonly referred to as plt. Think of this as your toolbox that contains all the tools you need to create a plot. We then create some sample data with lists x and y.

The subplots() function is like laying out a canvas for our painting. It gives us a figure (the whole picture) and an axis (think of this as a frame within the picture where our plot will go). We then plot x against y and use the label parameter to give a name to our data set. Finally, we call to display our masterpiece.

Adding a Legend to Your Plot

Now that we have a simple plot, let's add a legend to explain what 'My Data' is. Here's how you can do it:

# Continue from the previous code

# Adding a legend

# Display the plot with the legend

By calling ax.legend(), we tell matplotlib to add a legend to our plot. Since we've already labeled our data when plotting with label='My Data', matplotlib knows what to put in the legend. When you run the code, you'll see a box on the plot with the words "My Data" next to a line that matches the one in our plot. This box is the legend, and it automatically finds the best place to position itself to not obstruct the data.

Customizing Your Legend

The default legend is fine, but what if you want to make it more informative or stylish? Matplotlib offers several ways to customize your legend. Let's explore some of them:

# Continue from the previous code

# Customizing the legend
ax.legend(loc='upper left', shadow=True, title='Legend Title')

# Display the plot with the customized legend

In this example, we've added a few arguments to ax.legend(). The loc argument changes the location of the legend on the plot. You can use values like 'upper right', 'lower left', etc. The shadow argument adds a shadow to the legend box, making it pop out a bit. The title argument gives a title to the legend, which can be useful if you want to provide additional context.

Plotting Multiple Data Sets

What if you have multiple data sets you want to represent on the same plot? No problem! You can plot them and add a legend entry for each. Here's how:

# Sample data for a second line
y2 = [15, 15, 20, 25]

# Continue from the previous code

# Plotting the second data set
ax.plot(x, y2, label='My Second Data')

# Updating the legend to include the new data set

# Display the plot with both data sets and the updated legend

Now you have two lines on your plot, each with its label in the legend. By adding a second ax.plot() with a new label, you automatically update the legend to include it.

Dealing with Overlapping Legends

Sometimes, the legend might overlap with your data, making it hard to see what's going on. You can manually adjust the position of the legend to fix this:

# Continue from the previous code

# Manually adjusting the legend position
ax.legend(loc='center left', bbox_to_anchor=(1, 0.5))

# Display the plot with the adjusted legend

The bbox_to_anchor argument lets you specify the exact position of the legend. The coordinates (1, 0.5) place the legend to the right of the plot, centered vertically.

Legends with Multiple Columns

If you have a lot of entries in your legend, it might be useful to organize them into columns. Here's how you can do that:

# Continue from the previous code

# Organizing the legend into columns

# Display the plot with the multi-column legend

The ncol argument specifies the number of columns you want in your legend. This can make your legend clearer and better organized, especially if you have a long list of labels.


Adding a legend to your matplotlib plots is like giving your viewers a treasure map with all the important landmarks labeled. It turns a confusing array of colors and lines into a clear and informative chart that tells a story. With the simple tools provided by matplotlib, you can create legends that not only explain your data but also enhance the visual appeal of your plots.

Remember, the legend is your ally in the quest to make your data understood. It's the wise old sage that guides your audience through the epic tale of your data's journey. Use it wisely, and your plots will not only convey information but also captivate and inform your audience with clarity and style.

So go forth, brave data storytellers, and wield the power of the legend to illuminate the meaning within your charts and graphs. With each plot you create, you're not just making a graph; you're crafting a visual story that has the power to inform, persuade, and enlighten.