Kindly EditDocumentationTry the editor

Theme settings

Change the site's colors, fonts, widths, brand pictures, sections and style guide by hand, with a live preview.

Watch the video

Chapters and transcript Captions are included.

What it is for#

Kindly Edit > Theme changes the site's whole design by hand: its colors, fonts, corner radius, page widths and spacing, logo and default picture, which sections Add section offers, the style guide, theme CSS and the whole design as one JSON document. No AI is needed, and it works with AI access turned off. Since 0.9.21, the video button at the top, beside the publish status, plays the Theme settings video in a window over the screen.

It is the same design document your AI tools read and write (the client design abilities and wp kindly design), with the same checks, draft and publish steps. A change made here and a change made by an AI never drift apart.

Available in Kindly Edit 0.9.15 and later. The screen appears only when the active theme provides the design document, as themes built on the Kindly Edit Framework do. It needs an administrator account. Appearance > Kindly Design, the theme's older form, now opens this screen.

The screen#

Settings sit on the left in seven tabs; the site's real home page sits beside them as a preview and shows every change at once, before anything is saved. Choose Desktop or Phone above the preview for its width, or open it in a new tab. Links inside the preview stay inside it.

The status at the top says Unsaved changes, Draft saved, not published or Published.

  • Save draft keeps your changes. Visitors still see the published design; only administrators see the draft in the preview.
  • Publish makes the design public.
  • Discard draft goes back to the published design. With no draft saved yet, the same button says Undo changes and drops what you have changed on the screen.

If the settings change somewhere else while you work (for example, your AI saves a draft), the screen says so and offers Reload. Reloading gets the latest design; unsaved changes on the screen are lost.

Tabs#

Tab What you set
Colors Every theme color, grouped as Backgrounds, Text, Accents and lines, On dark and accent backgrounds, and More colors. Each has a color picker and a hex value. A text color shows its contrast with the background it sits on, and says hard to read below 4.5 to 1. Section tones at the top draws each of the four tones every section wears, updating as you change the colors.
Type The heading and body fonts. Choose a font tile (System, Inter, Helvetica, Avenir, Georgia, Charter, Palatino, Mono, or the current one) or type a font stack. A specimen shows the result. A font shows only when it is installed on your computer or the theme loads it.
Layout The corner radius buttons, cards, pictures and fields share: Square, 2px to 24px, or an Exact value. Then the widths and spacing: the page width and the reading width for paragraphs each have a slider, and side spacing and section spacing each have Small, Medium and Large steps. Every one also takes a typed value in px, rem, em, %, vw, vh or a clamp(), and a drawing shows the result.
Brand The logo, used wherever the theme shows the site, and the default picture, which stands in where a section needs a picture and none is chosen. Choose, Replace or Remove each one from the media library.
Sections Each section the theme offers. Turn one off to take it out of Add section; pages that already use it keep it. Starts as picks the tone and layout a new one starts with, and a note tells editors and AI how to use it.
Style guide Brand summary, Voice and tone, Visual direction, Photography and imagery, Do and Avoid. Your AI reads this before it writes or designs anything for the site.
Advanced Theme CSS, added after the theme's own styles, and the Design document: everything on the screen as one JSON document. Copy it, or paste a changed copy and choose Check and apply to review it on the screen before you save.

Checks#

Values are checked before they can be saved, with the same validation the theme gives the AI tools. An invalid hex value, length or font stack is marked on its field. JSON that does not parse is refused with That is not valid JSON.

About this page

Documents Kindly Edit 0.9.16. Source: includes/kindly-theme.php, assets/kindly-theme.js, includes/theme-design.php. Theme choices and account permissions can change which controls appear.

Type a word or phrase to search the full documentation.