When I first started working with 3D plots in Python, I realized that adding simple annotations or text labels could make my visualizations much more insightful. However, unlike 2D plots, adding text in a 3D space requires a little extra attention to positioning and scaling.
In this tutorial, I’ll show you how to add text to a 3D plot in Matplotlib using Python.
I’ll walk you through practical, real-world examples that I’ve personally used in data analysis and presentations here in the USA.
By the end of this article, you’ll be able to confidently add custom text, labels, and annotations to your 3D visualizations in Python, making your charts look professional and informative.
What is a 3D Plot in Matplotlib?
A 3D plot in Matplotlib is a way to display data points in three dimensions, X, Y, and Z, using the mpl_toolkits.mplot3d module. It helps visualize relationships between three numerical variables, often used in engineering, finance, and scientific data analysis.
For example, as a Python developer, I often use 3D plots to visualize geographical data, like plotting store locations across the USA with latitude, longitude, and altitude.
Add Text to a 3D Plot
Adding text to a 3D plot helps you highlight specific points, display coordinates, or label clusters. It’s especially useful when presenting data to teams or clients who may not be familiar with the raw numbers.
In my experience, clear labeling can transform a complex 3D visualization into a story, helping decision-makers quickly grasp key insights.
Method 1 – Using ax.text() in Python
The easiest way to add text to a 3D plot in Matplotlib is by using the ax.text() method. This function allows you to specify the X, Y, and Z coordinates where you want your text to appear.
Here’s a simple example that demonstrates how to use it.
# Import necessary libraries
import matplotlib.pyplot as plt
from mpl_toolkits.mplot3d import Axes3D
# Create a new figure
fig = plt.figure(figsize=(8, 6))
ax = fig.add_subplot(111, projection='3d')
# Sample data points
x = [10, 20, 30, 40]
y = [5, 15, 25, 35]
z = [2, 8, 18, 28]
# Plot the points
ax.scatter(x, y, z, color='blue', s=60)
# Add text labels to each point
ax.text(10, 5, 2, "Store A", color='red')
ax.text(20, 15, 8, "Store B", color='green')
ax.text(30, 25, 18, "Store C", color='orange')
ax.text(40, 35, 28, "Store D", color='purple')
# Set labels
ax.set_xlabel("Longitude")
ax.set_ylabel("Latitude")
ax.set_zlabel("Altitude")
plt.title("3D Store Locations with Text Labels (Python Matplotlib)")
plt.show()You can refer to the screenshot below to see the output.
In this Python example, I plotted four store locations and labeled each one with its name.
The ax.text() function takes the X, Y, and Z coordinates, followed by the text string and optional styling parameters.
Method 2 – Use ax.text3D() in Python
If you want more control over the 3D text placement, you can use ax.text3D(). It works similarly to ax.text() but is designed specifically for 3D axes.
Here’s how you can use it in Python:
import matplotlib.pyplot as plt
from mpl_toolkits.mplot3d import Axes3D
fig = plt.figure(figsize=(8, 6))
ax = fig.add_subplot(111, projection='3d')
# Sample data
x = [1, 2, 3]
y = [4, 5, 6]
z = [7, 8, 9]
# Plot data points
ax.scatter(x, y, z, color='cyan', s=80)
# Add text using text3D
for i in range(len(x)):
ax.text3D(x[i], y[i], z[i], f"Point {i+1}", color='black', fontsize=10)
ax.set_xlabel("X Axis")
ax.set_ylabel("Y Axis")
ax.set_zlabel("Z Axis")
plt.title("Adding Text to 3D Plot using text3D() in Python")
plt.show()You can refer to the screenshot below to see the output.
I personally prefer text3D() when working with larger datasets because it handles 3D transformations more smoothly. It ensures that the text scales correctly when you rotate or zoom in the 3D view.
Method 3 – Add Multiple Text Labels in a Loop
When working with multiple data points, manually adding text can be time-consuming. A more efficient approach is to use a loop to automatically label each data point.
Here’s how I usually do it in Python:
import matplotlib.pyplot as plt
from mpl_toolkits.mplot3d import Axes3D
import numpy as np
fig = plt.figure(figsize=(8, 6))
ax = fig.add_subplot(111, projection='3d')
# Generate random data
x = np.random.randint(10, 100, 10)
y = np.random.randint(10, 100, 10)
z = np.random.randint(10, 100, 10)
ax.scatter(x, y, z, color='teal', s=70)
# Add text labels
for i in range(len(x)):
ax.text(x[i], y[i], z[i], f"({x[i]}, {y[i]}, {z[i]})", fontsize=9, color='darkred')
ax.set_xlabel("X Coordinate")
ax.set_ylabel("Y Coordinate")
ax.set_zlabel("Z Coordinate")
plt.title("3D Plot with Multiple Text Labels in Python")
plt.show()You can refer to the screenshot below to see the output.
This method is perfect when you want to display coordinates or IDs for multiple points. It’s a clean, scalable way to annotate your 3D data in Python.
Method 4 – Add Annotations with Custom Styling
Sometimes, you may want to emphasize certain points with bold text, background color, or different font sizes. Matplotlib allows you to customize text styling easily.
Here’s a Python example that demonstrates how to do this:
import matplotlib.pyplot as plt
from mpl_toolkits.mplot3d import Axes3D
fig = plt.figure(figsize=(8, 6))
ax = fig.add_subplot(111, projection='3d')
# Example data
x = [5, 15, 25]
y = [10, 20, 30]
z = [2, 12, 22]
ax.scatter(x, y, z, color='navy', s=80)
# Add styled text
ax.text(5, 10, 2, "Low Point", color='white', backgroundcolor='darkred', fontsize=10, fontweight='bold')
ax.text(15, 20, 12, "Mid Point", color='black', backgroundcolor='yellow', fontsize=10)
ax.text(25, 30, 22, "High Point", color='white', backgroundcolor='green', fontsize=10, fontstyle='italic')
ax.set_xlabel("X Axis")
ax.set_ylabel("Y Axis")
ax.set_zlabel("Z Axis")
plt.title("Adding Styled Text to 3D Plot in Python")
plt.show()You can refer to the screenshot below to see the output.
This approach is great when you want to highlight specific regions or thresholds. For example, I often use this technique to mark “high sales” or “low performance” zones in my 3D business analytics charts.
Tips for Positioning and Formatting Text in 3D
Here are a few practical tips I’ve learned from experience when adding text to 3D plots in Python:
- Keep text short and clear, avoid cluttering your chart.
- Use contrasting colors for visibility against the background.
- Adjust fontsize and fontweight for better readability.
- Rotate the 3D view to test how text appears from different angles.
- Use ax.view_init(elev, azim) to fix the camera angle for presentations.
Common Mistakes to Avoid
Even experienced Python developers sometimes make small mistakes with 3D text placement.
Here are a few to watch out for:
- Overlapping text: Always space out labels to avoid visual clutter.
- Hard-to-read colors: Choose text colors that stand out from the plot background.
- Ignoring scaling: When zooming or rotating, ensure text remains legible.
- Misaligned coordinates: Double-check that your X, Y, Z values match the data points.
When I first learned how to add text to 3D plots in Python, I underestimated how much clarity it could bring to complex data. Now, I use it regularly in my analytics dashboards and Python reporting scripts, especially when presenting to stakeholders here in the USA.
Adding text to 3D plots is not just about labeling points; it’s about telling a story with your data. With the methods and examples above, you can create professional, readable, and interactive 3D visualizations that stand out in any presentation.
You may like to read:
- Plot Asymmetric Error Bars in Matplotlib
- Use plot_date() with Error Bars in Python Matplotlib
- Add Multiple Line Text to a Plot in Matplotlib
- Add a Text Box to a Plot in Matplotlib
I am Bijay Kumar, a Microsoft MVP in SharePoint. Apart from SharePoint, I started working on Python, Machine learning, and artificial intelligence for the last 5 years. During this time I got expertise in various Python libraries also like Tkinter, Pandas, NumPy, Turtle, Django, Matplotlib, Tensorflow, Scipy, Scikit-Learn, etc… for various clients in the United States, Canada, the United Kingdom, Australia, New Zealand, etc. Check out my profile.
