Kindly EditDocumentationTry the editor

Global elements and instance properties

Publish one shared element and reuse linked instances with controlled local text.

Watch the video

Chapters and transcript Captions are included.

Linked content#

A global element has a shared source and linked instances. Publishing the source updates every linked instance that uses it. This differs from a saved template, which inserts an independent copy.

Use a global for a repeated notice, contact panel, or other piece that must remain synchronized. Decide whether the shared source or a local instance should own each word before editing.

Kindly Edit > Saved in WordPress lists global elements in a table with the pages each is Used on and its status. To change one, edit a page that uses it and select it there. Trashing one leaves every page showing what it last showed. The video button in its Global elements header (0.9.21 and later) plays the Global elements video. See Saved templates for the rest of that screen.

Source and instance#

The source is stored as kindly_global. A linked instance uses div.ke-global with data-ke-global identifying the source. Properties marked with data-ke-prop can accept instance text through data-ke-props.

Edit a source draft, review it, and publish it separately. Publishing the source changes linked output without requiring every containing page to be published again. Instance properties remain local within the allowed property contract.

Unlinking turns the instance into an independent copy. Future source updates no longer affect it. If a source is missing or trashed, the instance retains its saved copy rather than vanishing. Restoring the source restores the link's ability to resolve.

Nested globals are bounded to three levels and cannot reference themselves. Avoid deep nesting even within the limit; it makes ownership harder to understand.

Permissions and code#

Source management requires Developer access and theme-editing capability. Global content does not carry executable element JavaScript or PHP; CSS follows the authoring gate. Test a global change on multiple pages and screen sizes before publishing it broadly.

About this page

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

Type a word or phrase to search the full documentation.