Kindly EditDocumentationTry the editor

Dynamic fields and WordPress content

Connect elements to the current post, author, site, archive, or public metadata.

Watch the video

Chapters and transcript Captions are included.

Bind a value#

Dynamic bindings let one layout display different data for the current WordPress context. Select an element, choose a supported dynamic field, and set a fallback when the data can be empty. The editor shows an editable placeholder; public rendering resolves the value.

Text fields include title, excerpt, published and modified dates, author, author biography, terms, public metadata, site title and tagline, archive title and description, and comment information. URL fields include the current item URL, author URL, public metadata, and home URL. Images can use a featured image, author avatar, site logo, or public metadata. Content bindings fill a content box.

Formatting and limits#

Text bindings can add before and after text, a fallback, a word limit, and a date format where applicable. Before, after, and fallback values are limited to 200 characters; word limits range from 1 to 200; date-format strings are limited to 40 characters. Image sizes come from WordPress's registered sizes.

A title, excerpt, category or name with an ampersand, a dash or curly quotes shows once, as typed: "C & R" stays "C & R". Before 0.9.20 it could show the HTML code instead, such as C & R, on a theme template or loop, and template names in the admin bar and corner label showed codes like &. Metadata values are shown as stored.

Metadata keys beginning with an underscore and protected metadata are excluded. A dynamic field is not a way to expose private WordPress storage.

Context matters#

On a normal page, the queried page supplies context. In a loop, the current loop item supplies it. In a theme template, the requested post or archive supplies it. Check the visitor page in more than one context, including an item with missing data.

The serialized binding lives in data-ke-dyn. The server resolves values during rendering. Do not replace a dynamic field with literal text if the intent is to keep it connected; remove or change the binding explicitly.

Live providers#

Live content slots use registered sources and declared fields. They can render posts, menus, search, sign-in, site identity, breadcrumbs, author information, and widget areas. Their data stays with its WordPress owner. Manage posts in Posts and menus in their menu screen rather than editing generated output as if it were static page text.

See Loops and Theme templates for reusable dynamic layouts.

About this page

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

Type a word or phrase to search the full documentation.