[Bug] Plotly express color_continuous_scale ignored when template has autocolorscale=True

Problem

When a Plotly template sets coloraxis_autocolorscale=True, the color_continuous_scale argument passed to plotly.express functions is ignored.

Reproduction

import plotly.express as px
import plotly.graph_objects as go

df = px.data.gapminder().query("year == 2007")
template = go.layout.Template(layout=go.Layout(coloraxis_autocolorscale=True))

# User specifies colorscale - THIS IS IGNORED
fig = px.choropleth(
    df, 
    locations="iso_alpha", 
    color="lifeExp",
    color_continuous_scale=["red", "yellow", "green"],
    template=template,
)
fig.show()  # Renders with auto-detected scale, not red-yellow-green

Root cause

As per the plotly docs, when autocolorscale=True, the colorscale is auto-detected based on the data, ignoring any explicit colorscale setting (this itself is quite confusing behaviour I think, but that's a separate issue - let's assume for now it should be left with that logic):

In case colorscale is unspecified or autocolorscale is True, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.

In the following code autocolorscale is not set on coloraxis1. This means the template's autocolorscale=True is inherited, causing the user's color_continuous_scale to be completely ignored:

plotly.py/plotly/express/_core.py

Lines 2707 to 2716 in f083977

    
           layout_patch["coloraxis1"] = dict( 
        
               colorscale=colorscale_validator.validate_coerce( 
        
                   args["color_continuous_scale"] 
        
               ), 
        
               cmid=args["color_continuous_midpoint"], 
        
               cmin=range_color[0], 
        
               cmax=range_color[1], 
        
               colorbar=dict( 
        
                   title_text=get_decorated_label(args, args[colorvar], colorvar) 
        
               ),

Proposed fix

When color_continuous_scale is explicitly provided, set autocolorscale=False on coloraxis1 to ensure the user's colorscale is respected. I can raise a PR for this if you like!

Agreed that this isn't the most intuitive behavior. We would be open to making this change if you could open a PR. The only notable concern would be around backwards compatibility if anyone was assuming this behavior.

@robertclaus

Hi @robertclaus, I've opened a PR to fix this in #5439.

I've gone for the "light touch" fix that only affects Plotly Express so there shouldn't be any concerns around backwards compatibility here.

Just to be clear, as I see it the underlying behaviour of plotly.js is quite confusing and unexpected:

In case colorscale is unspecified or autocolorscale is True, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.

i.e. when autocolorscale=True and colorscale is specified explicitly, colorscale will be ignored. To me it really feels like the "or" condition here should be "and", so that autocolorscale is only relevant when colorscale isn't specified explicitly. I don't know whether this is a bug or intentional.

Either way, I decided that for simplicity I would just fix this on the Plotly Express side (where the bug is most obvious and problematic) to ensure there's no backwards compatibility issues.

Navigation Menu

Repository navigation

[Bug] Plotly express `color_continuous_scale` ignored when template has `autocolorscale=True` #5433

Problem

Reproduction

Root cause

Proposed fix

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

	layout_patch["coloraxis1"] = dict(
	colorscale=colorscale_validator.validate_coerce(
	args["color_continuous_scale"]
	),
	cmid=args["color_continuous_midpoint"],
	cmin=range_color[0],
	cmax=range_color[1],
	colorbar=dict(
	title_text=get_decorated_label(args, args[colorvar], colorvar)
	),

[Bug] Plotly express color_continuous_scale ignored when template has autocolorscale=True #5433

Description

Problem

Reproduction

Root cause

Proposed fix

Activity

robertclaus commented on Nov 26, 2025

antonymilne commented on Dec 2, 2025

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

[Bug] Plotly express `color_continuous_scale` ignored when template has `autocolorscale=True` #5433