Legends
Legends display trace information, allowing users to identify data series in your charts. Clicking or double-clicking legend items lets users toggle visibility of specific data series interactively.
Show/hide legend
Control whether the legend is displayed on your chart.
<Chart Title>
Chart:
- Type: <chart_type>
- <axis mappings>
Chart styles:
- Hide legend
The following example uses this prompt structure with the built-in Plotly Studio dataset:
Product Weight vs Length by Defect Status
Chart:
- Type: scatter
- X: Weight
- Y: Length
- Color: Defect
Chart styles:
- Hide legend


Legend orientation
Control whether legend items are arranged horizontally or vertically.
<Chart Title>
Chart:
- Type: <chart_type>
- <axis mappings>
Chart styles:
- Use horizontal legend
The following example uses this prompt structure with the built-in Plotly Studio dataset:
Product Weight vs Length by Factory
Chart:
- Type: scatter
- X: Weight
- Y: Length
- Color: Factory location
Chart styles:
- Use horizontal legend


Legend background color
Set the background color of the legend box. You can use CSS color names (e.g., "lightblue", "white"), hex codes (e.g., "#F5F5F5"), or RGB values (e.g., "rgb(255, 255, 255)").
<Chart Title>
Chart:
- Type: <chart_type>
- <axis mappings>
Chart styles:
- Set legend background color to <color>
The following examples show a few color options:
Product Weight vs Length by Factory
Chart:
- Type: scatter
- X: Weight
- Y: Length
- Color: Factory location
Chart styles:
- Set legend background color to lightblue
Product Weight vs Length by Factory
Chart:
- Type: scatter
- X: Weight
- Y: Length
- Color: Factory location
Chart styles:
- Set legend background color to lightgray
Product Weight vs Length by Factory
Chart:
- Type: scatter
- X: Weight
- Y: Length
- Color: Factory location
Chart styles:
- Set legend background color to lightyellow
Prompt keywords reference
Use a Chart styles: section in your prompt to customize legend appearance.
Chart styles:
- Hide legend
- Show legend at top right
- Use horizontal legend
- Set legend background color to lightblue
- Set legend title to "Categories"
Here are some keyword suggestions to use in this section:
| Keyword/Phrase | Description | Example |
|---|---|---|
| Hide legend | Remove the legend from the chart | - Hide legend |
| Show legend | Display the legend | - Show legend |
| Show legend at | Control where the legend appears | - Show legend at top right |
| Legend title | Set a custom title for the legend | - Set legend title to "Categories" |
| Horizontal/vertical legend | Set legend to horizontal or vertical orientation | - Use horizontal legend- Use vertical legend |
| Legend background color | Set the background color of the legend box | - Set legend background color to lightblue |
| Legend border color | Set the color of the border around the legend | - Set legend border color to gray |
| Legend border width | Set the width of the border around the legend | - Set legend border width to 2px |
| Legend font size | Adjust the size of text in the legend | - Set legend font size to 12 |
| Legend text color | Change the color of legend text | - Set legend text color to gray |
| Reverse legend order | Flip the order of items in the legend | - Reverse legend order |