Kindly EditDocumentationTry the editor

Colors, backgrounds, and gradients

Use native color and image settings while preserving theme roles and readable contrast.

Watch the video

Chapters and transcript Captions are included.

Text and icon color#

Select the element and open Style → Colors and background. The color control is named for the content it affects. Theme choices use the site’s design tokens. A custom element value is an override for the selected device and state.

Opening a color control does not set a color. Transparent and partially transparent values are shown with a checkerboard and descriptive wording. Reset removes the override so the inherited or theme value can return.

Background pictures#

Under Background image, choose Choose a background picture (Change background picture once it has one). It offers Media library, or a field where you paste a picture's address (0.9.15). The inspector distinguishes a directly assigned picture from a theme image, gradient, or multiple layers. A new picture or address intentionally replaces the background image for that scope.

With an image present, Image size offers Cover, Contain, or Original. Image position selects its focus within the box. Image repeat can tile across, down, both directions, or not repeat; each choice is drawn as tiles beside its name. Old image-dependent settings remain inspectable when the image is absent instead of being silently erased.

Gradients and overlays#

The native gradient controls cover supported linear or radial gradients and their color stops. Since 0.9.15 the gradient is shown and grabbed: drag the ball on the ring to turn its angle (Shift for 15° steps; the arrow keys work too), drag a color's ball along the bar to move that color, and click the bar to add a color there. More complex existing values are retained until deliberately changed; the panel does not pretend every possible CSS gradient is represented by the simplified controls. An overlay is separate from the image and changes how strongly the background shows behind text.

Contrast and semantics#

Keep informational images as image elements with alternative text. Background images are presentation and do not supply image alt text. Inspect text against the actual image, especially at narrow widths where the crop changes. A tone preset can provide a consistent readable palette; a custom override can still make that palette unreadable.

About this page

Documents Kindly Edit 0.9.16. Source: assets/editor.js:developerStylePanel, assets/editor.js:devGradient, assets/editor.js:devOverlay, includes/tones.php. Theme choices and account permissions can change which controls appear.

Type a word or phrase to search the full documentation.