{"id":2405,"date":"2025-05-16T08:38:11","date_gmt":"2025-05-16T12:38:11","guid":{"rendered":"https:\/\/blogs.mathworks.com\/graphics-and-apps\/?p=2405"},"modified":"2026-01-30T20:34:32","modified_gmt":"2026-01-31T01:34:32","slug":"labeling-bars-made-easy","status":"publish","type":"post","link":"https:\/\/blogs.mathworks.com\/graphics-and-apps\/2025\/05\/16\/labeling-bars-made-easy\/","title":{"rendered":"Labeling Bars Made Easy"},"content":{"rendered":"\r\n\r\n\r\n
\"Benjamin<\/td>\r\nGuest Writer: Benjamin Kraus<\/a>\r\n<\/strong>Ben has been a Software Engineer on the MATLAB Graphics and Charting Team since 2015. Although his first exposure to MATLAB was in 2000 as an undergraduate studying Biological Engineering and Computer Science at Cornell University, he really grew to love MATLAB while completing his PhD in Biomedical Engineering at Boston University. Throughout graduate school Ben used MATLAB nearly every day for nearly every aspect of his research: from running his experimental setup, collecting data, and analyzing data, to producing figures for his thesis and research papers. Ben joined MathWorks in 2013 and spent a little over a year in the Engineering Development Group at MathWorks before joining the Graphics and Charting Team. When he isn't at a computer, Ben enjoys biking, rowing, and sailing, and is a member of The Fast and the Fouriers running club at MathWorks.<\/td>\r\n<\/tr>\r\n<\/tbody>\r\n<\/table>\r\n
\r\n
\r\n\r\n
\r\n\r\n<\/div>\r\n
\"Open<\/a><\/div>\r\n
Although the Charting Team loves adding completely new chart types to MATLAB (such as violin plot<\/a>), we try not to forget our old favorites, including the trusty bar plot. We've added two new features to bar plots in R2024a and R2024b that makes it just a bit easier to get that perfect bar plot: the ability to adjust the amount of whitespace between groups of bars and a way to easily add labels to your bar plots.<\/div>\r\n
To show off these new features, I'm going to build a bar plot of my biking, rowing, and running mileage since 2020. I spend a good chunk of my day at a computer, so I try to compensate for that by getting outside for a daily workout. Let's take an initial look at the data:<\/div>\r\n
\r\n
\r\n
ax = axes;<\/div>\r\n<\/div>\r\n
\r\n
years = [\"2020\"<\/span>, \"2021\"<\/span>, \"2022\"<\/span>, \"2023\"<\/span>, \"2024\"<\/span>];<\/div>\r\n<\/div>\r\n
\r\n
run = [1359, 1200, 1027, 1019, 439];<\/div>\r\n<\/div>\r\n
\r\n
bike = [1128, 1679, 1268, 1043, 651];<\/div>\r\n<\/div>\r\n
\r\n
row = [68, 164, 253, 271, 548];<\/div>\r\n<\/div>\r\n
\r\n
b = bar(years, [run; bike; row]);<\/div>\r\n<\/div>\r\n
\r\n
legend([\"Run\"<\/span>, \"Bike\"<\/span>, \"Row\"<\/span>])<\/div>\r\n<\/div>\r\n
\r\n
title(\"Annual Miles\"<\/span>)<\/div>\r\n
\r\n
\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n
As you can see, like many people, I logged a lot of running and biking miles in 2020. Unfortunately, a recent injury has curtailed a lot of my running, but I've replaced it with more rowing (a relatively new sport for me).<\/div>\r\n

Add labels to a bar plot<\/h2>\r\n
One issue with the bar plot above is that it can be hard to read precise values.<\/span> You've got to visually trace from the top of each bar back to the y-axis and then interpolate to get an approximate value. A quick way to fix that is to add grid lines:<\/div>\r\n
\r\n
\r\n
ax.YGrid='on'<\/span>;<\/div>\r\n
\r\n
\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n
This helps a little, but you still need to interpolate to get an approximate value. Sometimes you want to show the actual value as a label above each bar. A new feature in R2024b makes this much easier. Starting in R2024b, you can set the <\/span>Labels<\/span><\/a> property to add labels automatically aligned with the top of each bar.<\/span> Each set of data (run, bike, and row) corresponds to a different Bar<\/span> object, so we need to set the Labels<\/span> property individually for each set of data. Let's see what that looks like:<\/div>\r\n
\r\n
\r\n
b(1).Labels = run;<\/div>\r\n<\/div>\r\n
\r\n
b(2).Labels = bike;<\/div>\r\n<\/div>\r\n
\r\n
b(3).Labels = row;<\/div>\r\n
\r\n
\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n
The astute observer will note that I set those properties using the original data in the form of numeric vectors. When you do that, MATLAB will automatically convert those values into strings. However, if you prefer, you can set the labels to include whatever strings you want.<\/div>\r\n

Control bar and group width in a bar plot<\/h2>\r\n
With the new labels you can now tell exactly how many miles I logged each year, but the chart is getting a bit cluttered. Let's see what we can do to clean that up.<\/div>\r\n
To start with, I'm going to eliminate some white space by making each individual bar and each group of bars a bit wider using two properties: BarWidth<\/span><\/a> and GroupWidth<\/span><\/a>. The BarWidth<\/span> property has been available in MATLAB for many years. This property is a ratio that controls the width of each individual bar, with a value of 0 meaning the bars should have no width and a value of 1 meaning the bars should touch each other (occupy 100% of the space available). The GroupWidth<\/span> property was added in MATLAB R2024a and controls the width of each group of bars. Similar to BarWidth<\/span>, GroupWidth<\/span> is a ratio: a value of 0 for means the group should have no width and a value of 1 means each group should be touching the neighboring group.<\/div>\r\n
\r\n
\r\n
set(b,BarWidth=0.9,GroupWidth=0.9)<\/div>\r\n
\r\n
\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n
That helped a lot, but a few labels are still overlapping. Let's decrease the font size to make more room.<\/div>\r\n
\r\n
\r\n
fontsize(b,8,\"points\"<\/span>)<\/div>\r\n
\r\n
\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n
Now the labels no longer overlap, but the chart is still a little cluttered. The y-axis and grid lines are not as useful once you have labels, so I'm going to turn those off.<\/div>\r\n
\r\n
\r\n
axis('off'<\/span>)<\/div>\r\n
ax.XAxis.Visible = true;<\/div>\r\n
\r\n
\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n
\r\n
<\/div>\r\n<\/div>\r\n<\/div>\r\n

Label location and color<\/h2>\r\n
That looks pretty good, but there are two more features of the bar labels I want to show off, which is automatic color selection and label location. To demonstrate these features, I'm going to make the bar labels a little smaller and then move them into the bars by setting the LabelLocation<\/span><\/a> property.<\/div>\r\n
\r\n
\r\n
set(b,LabelLocation='end-inside'<\/span>)<\/div>\r\n<\/div>\r\n
\r\n
set(b,FontSize=7)<\/div>\r\n
\r\n
\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n
Notice how the labels on the yellow bars stay black (because they are against a light background), but the other labels change to white (to contrast against the blue and red bars). If you would prefer to pick the label color yourself, you can set the LabelColor<\/span><\/a> property (using a single color for all the bars or one color per bar).<\/div>\r\n
Other properties you can use to customize your labels include: FontName<\/span><\/a>, FontSize<\/span><\/a>, FontWeight<\/span><\/a>, FontAngle<\/span><\/a>, and Interpreter<\/span><\/a>.<\/span><\/div>\r\n

Want more flexibility with your labels?<\/h2>\r\n
What if you need just a bit more flexibility with your label placement, or you are stuck in an older release and can't leverage this new feature?<\/div>\r\n
Although it requires a bit more fiddling, you can do something similar using the XEndPoints<\/span><\/a> and YEndPoints<\/span><\/a> properties, which were added in MATLAB R2019b. These properties give you the exact x- and y-coordinates of the tips of the bars, which you can pass into the text<\/span> command to create labels at each bar. This approach requires a little more patience to get correct (such as setting the HorizontalAlignment<\/span> and VerticalAlignment<\/span>) but it produces text objects that you can position anywhere you like, giving you complete flexibility over the label properties.<\/div>\r\n
\r\n
\r\n
b = bar(years, [run; bike; row],BarWidth=0.9,GroupWidth=0.9);<\/div>\r\n<\/div>\r\n
\r\n
legend([\"Run\"<\/span>, \"Bike\"<\/span>, \"Row\"<\/span>])<\/div>\r\n<\/div>\r\n
\r\n
title(\"Annual Miles\"<\/span>)<\/div>\r\n<\/div>\r\n
\r\n
x = [b.XEndPoints]; % Combine all the x-coordinates into one matrix.<\/span><\/div>\r\n<\/div>\r\n
\r\n
y = [b.YEndPoints]; % Combine all the y-coordinates into one matrix.<\/span><\/div>\r\n<\/div>\r\n
\r\n
text(x,y,string(y),HorizontalAlignment='center'<\/span>,VerticalAlignment='bottom'<\/span>,FontSize=8)<\/div>\r\n
\r\n
\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n
<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n
Let me know in the comments what other bar labeling features you'd like to see.<\/div>\r\n
<\/div>\r\n
<\/div>\r\n \r\n\r\n<\/div>\r\n