Kindly EditDocumentationTry the editor

Site variables and reusable classes

Manage shared colors, fonts, sizes, and styles that can update elements across the site.

Watch the video

Chapters and transcript Captions are included.

Choose the right scope#

A one-off element style belongs to the page. A reusable class or site variable belongs to the site's design system and can affect many pages immediately. Before changing a class, check its uses and confirm which style target is active: This element or the named class.

Variables cover colors, fonts, and sizes. Their stable IDs produce CSS variables such as var(--kv-id). Reusable classes use stable kc- identifiers. Renaming a display label does not require rewriting every use.

Work with a class#

Select an element, create or choose a class, and edit the class's styles. Apply the same class to another element to share that styling. Order matters when multiple classes compete at equal specificity: later classes win. The generated class rules use increased specificity, while element settings remain the more specific override.

Return to This element for a local exception. Clearing that exception reveals the class or theme value again.

Manage the library#

The design-system interface supports rename, duplicate, delete, ordering, import, and export. Use reports include pages, posts, shared parts, templates, drafts, and references between classes and variables. Inspect references before deleting. Imports remap colliding identifiers rather than assuming an imported ID belongs to the same design.

Save behavior#

Design-system changes save site-wide immediately and have their own Undo. The page's Save, Publish, and Undo history do not roll them back. Treat a shared variable change as a site design change even while working on an unpublished page draft.

Reads require page-editing access. Writes require Developer access and theme-editing capability. Updates include a revision token; a stale revision returns a conflict rather than overwriting another editor's changes. Refresh the library and reconcile the change before retrying.

Implementation#

The cantata_edit_design_system option stores the library. The /design-system REST endpoint reads and writes it. The server validates variable types and accepted style declarations, generates the public stylesheet, and preserves stable identifiers for references.

About this page

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

Type a word or phrase to search the full documentation.