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.
Unlink and recovery#
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.