- Where to find it
- Labelled Disabled in the "Selected Component" section of the Modify drawer.
- Offered by
- The Button component. Other components do not have this setting.
- Per device
- Yes — you can set one value for every screen, or separate values for phone, tablet, and desktop.
In plain English
A disabled button is visible but inert: it is drawn faded, the pointer shows it cannot be used, and clicking does nothing. Browsers and screen readers both understand the state, so it is announced rather than merely looking greyed out.
A button linking somewhere loses its address when disabled rather than keeping it and cancelling the click. That is deliberate — cancelling would need JavaScript to have loaded first, and a widget has to be correct the moment it appears, before any script runs.
It is worth being honest about what this setting is for. In a page built in the composer nothing changes at runtime, so a disabled button is disabled for every visitor forever. That makes it useful for showing an unavailable option, and not useful for a state that depends on what the visitor has done.
What each option does
| Option | What you will see |
|---|---|
false | The button works normally. The default. |
true | The button is dimmed, unclickable, and announced as unavailable. |
When you would use it
- Showing an option that exists but is not available — a sold-out plan, a feature on a higher tier.
- Illustrating a disabled state in a design or documentation page.
How to change it
- Click the button on the canvas.
- In the Modify drawer, open "Selected Component", then "Disabled".
- Choose true to disable it, or false to restore it.
Watch out for
- A disabled button explains nothing by itself. If the visitor could do something to enable it, say what in text nearby — a disabled control with no explanation is one of the most common accessibility complaints.
- Disabled buttons are deliberately low contrast, which makes them hard to read. That is the correct appearance for something unavailable, so do not fight it with a colour override.
- Consider removing the button instead. An option that will never become available is usually better absent than present and dead.
Related settings
Where to go next
- Back to the Button component — everything else it can do.
- The Composer — the editing surface these settings live in.
- Publishing — how a change like this reaches your live site.