Anonymous contributor's avatar
Anonymous contributor
Anonymous contributor's avatar
Anonymous contributor
Published Jul 4, 2024
Contribute to Docs

In Plotly, the .box() method is present in the plotly.express high-level interface, is used to make box plots with one or two variables. A box plot is a visual representation of the distribution of numeric data through quartiles. It uses boxes and lines to depict the distributions of one or more groups of numeric data. The box limits indicate the range of the central 50% of the data, with a central line marking the median value.


plotly.express.box(data_frame=None, x=None, y=None, color=None, labels=None, title=None, ...)
  • data_frame: The dataset containing the variables to be plotted.
  • x: The data for the x-axis.
  • y: The data for the y-axis.
  • color: A column name in the data frame that determines the color of the boxes.
  • labels: Key-value pairs with the original column names as the key and the custom column names as the value.
  • title: The title of the box plot.

Tthe only required parameter is data_frame, while all others are optional and used to customize the plot.

Note: The ellipsis (…) indicates that there can be additional optional arguments beyond those listed here.


The below example shows how to use the .box() method to create box plots:

# Importing plotly.express as px
import plotly.express as px
# Loading a built-in data frame
df = px.data.tips()
# Creating the box plot with the variable time as the x variable and the variable total_bill as the y variable
fig = px.box(data_frame=df, x="time", y="total_bill", title="The Total Bill Spent On Meals")
# Showing the box plot

In the example, a plot of total meal expenses ($) is generated from the data frame. The x axis corresponds to the time variable, which categorizes data into two distinct points: Dinner and Lunch. The y axis represents the total_bill variable, showing the distribution of expenses for each mealtime. Consequently, the output includes two box plots, each depicting the variability in total bills between Dinner and Lunch.

The above code produces the following output:

The output for the above example

All contributors

Looking to contribute?

Learn Python:Plotly on Codecademy