Skip to main content
Documentation/Dynamic Data/Fields Reference

Fields Reference

Expand a field to see what it displays and the options available for it. For shared formatting and fallback controls, see Field Options.

Fields use the current item: the viewed post in a template, each post in a Post Loop, or each term in a Term Loop. The chooser shows fields compatible with the control you are editing.

The Insert Dynamic Data dialog showing field categories
The Insert Dynamic Data dialog showing field categories

Post

Post Title

The current post’s title, or a fixed post selected in its options.

  • Search Post — Find a fixed post to read instead of the current post.
  • Post ID — The fixed post’s numeric ID; leave unset to use the current post.

Post Content

The current post’s content, including its WordPress formatting and shortcodes. For an area editable separately in each item, see Template Content Area.

Post Excerpt

The current post’s excerpt.

Post Permalink

The current post’s permalink, or a fixed post selected in its options.

  • Search Post — Find a fixed post to read instead of the current post.
  • Post ID — The fixed post’s numeric ID; leave unset to use the current post.

Post Date

The post’s publication or modification date. The initial Type is Post Modified, with format F j, Y.

  • Format — Default, September 13, 2026 (F j, Y), 2026-09-13 (Y-m-d), 09/13/2026 (m/d/Y), 13/09/2026 (d/m/Y), Custom, Human.
  • Custom Format — PHP date-format string; appears for Custom.
  • Type — Post Published, Post Modified.

Post Time

The post’s publication or modification time. The initial Type is Post Modified.

  • Type — Post Published, Post Modified.
  • Format — Default, 2:53 am (g:i a), 2:53 AM (g:i A), 02:53 (H:i), Custom, Human.
  • Custom Format — PHP date-format string; appears for Custom.

Post Terms

Terms assigned to the current post.

  • Taxonomy — Which assigned terms to list.
  • Link — Whether listed terms link to their archives.
  • Separator — Text placed between listed terms.

Comments Number

The comment count expressed using separate text for zero, one, and multiple comments. Use % for the count in Multiple comments, for example % comments.

  • No comments — Wording for zero comments.
  • One comment — Wording for one comment.
  • Multiple comments — Wording for more than one comment; % inserts the count.

Featured Image

The current post’s featured image.

Featured Image (URL)

The URL of the current post’s featured image.

Post Image Attachment

One image attached to the post, selected by its zero-based index. Index 0 means the first attachment; attached media is not a list of every image embedded in the content.

  • Image Index — Which image to use; numbering begins at 0.

Post Image Attachments

A gallery of images attached to the current post. These are the post’s media attachments, rather than every image embedded in its content.

Post Custom Field

Reads a stored value from the current post.

  • Key — The metadata key to read from the current post.

Post Custom Field (Image URL)

Reads an image stored as a URL or attachment ID from the current post.

  • Key — The metadata key to read from the current post.

Post Custom Field (Oembed URL)

Reads an embedded video from a stored oEmbed URL from the current post.

  • Key — The metadata key to read from the current post.

The title of the featured image’s media attachment.

The featured image’s alternative text.

The featured image’s caption.

Reads a stored value from the featured image’s media attachment.

  • Key — The metadata key to read from the featured image’s media attachment.

Reads an image stored as a URL or attachment ID from the featured image’s media attachment.

  • Key — The metadata key to read from the featured image’s media attachment.

Reads an embedded video from a stored oEmbed URL from the featured image’s media attachment.

  • Key — The metadata key to read from the featured image’s media attachment.

Author

Author Name

The post author’s name selected in Field.

  • Field — The user-name property to display. Choices: Display Name, First Name, Last Name.

Author Bio

The current post author’s biographical information from their WordPress profile.

Author Email

The current post author’s email address.

Author Website

The website URL from the current post author’s profile.

Author Avatar

The current post author’s avatar image.

Author Avatar (URL)

The URL of the current post author’s avatar.

Custom Field

Reads a stored value from the current post author’s user profile.

  • Key — The metadata key to read from the current post author’s user profile.

Custom Field (Image URL)

Reads an image stored as a URL or attachment ID from the current post author’s user profile.

  • Key — The metadata key to read from the current post author’s user profile.

Custom Field (Oembed URL)

Reads an embedded video from a stored oEmbed URL from the current post author’s user profile.

  • Key — The metadata key to read from the current post author’s user profile.

Term

Term fields use the current term in a Term Loop or taxonomy archive.

Term Name

The current term’s name.

Term Description

The current term’s description.

The URL of the current term’s archive.

Term Count

The number of items assigned to the current term.

Term ID

The current term’s numeric WordPress ID.

Term Custom Field

Reads a stored value from the current term.

  • Key — The metadata key to read from the current term.

Archive

Archive Title

The title of the current archive. Disable Prefix removes prefixes such as “Category:”.

  • Disable Prefix — Remove the archive-title prefix.

Archive Description

The description of the current archive.

Current User

These fields read the visitor’s user profile. Available values depend on whether they are logged in.

User Name

The current visitor’s name selected in Field.

  • Field — The user-name property to display. Choices: Display Name, First Name, Last Name.

User Bio

The logged-in visitor’s biographical information from their WordPress profile.

User Email

The logged-in visitor’s email address.

User Website

The website URL from the logged-in visitor’s profile.

User Avatar

The current visitor’s avatar image.

User Avatar (URL)

The URL of the current visitor’s avatar.

Custom Field

Reads a stored value from the logged-in visitor’s user profile.

  • Key — The metadata key to read from the logged-in visitor’s user profile.

Custom Field (Image URL)

Reads an image stored as a URL or attachment ID from the logged-in visitor’s user profile.

  • Key — The metadata key to read from the logged-in visitor’s user profile.

Custom Field (Oembed URL)

Reads an embedded video from a stored oEmbed URL from the logged-in visitor’s user profile.

  • Key — The metadata key to read from the logged-in visitor’s user profile.

Site Info

Site Title

The site title from WordPress settings.

Site Tagline

The site tagline from WordPress settings.

Site URL

The WordPress Address URL where WordPress is installed.

Home URL

The Site Address URL visitors use to reach the site.

Admin Email

The administration email address from WordPress settings.

The logo set in the WordPress Customizer.

Site Logo (URL)

The URL of the logo set in the WordPress Customizer.

RSS URL

A selected site feed or pingback URL. The default is RSS2 URL.

  • Type — Atom URL, RDF URL, RSS URL, RSS2 URL, Pingback URL, Comments Atom URL, Comments RSS2 URL.

Logout URL

The WordPress logout URL. Redirect URL sets where the visitor goes after logout.

  • Redirect URL — The destination after logout.

URL & Query

Search Query

The search text from the current WordPress search request.

URL Parameter

A named parameter from the URL query string. For ?campaign=spring, Parameter Name campaign reads spring.

  • Parameter Name — The exact query-string key to read.

Common UTM Tags

A selected UTM parameter from the URL query string.

  • UTM Tag — Which campaign-tracking parameter to read. Choices: Source, Medium, Campaign, Term, Content.

Utility

Current Date

The current date/time formatted for display. The initial format is F j, Y.

  • Format — Default, September 13, 2026 (F j, Y), 2026-09-13 (Y-m-d), 09/13/2026 (m/d/Y), 13/09/2026 (d/m/Y), Custom, Human.
  • Custom Format — PHP date-format string; appears for Custom.

Shortcode

The result of running the shortcode entered in Shortcode. Enter the complete shortcode with its brackets, for example [site_notice].

  • Shortcode — The complete shortcode expression to execute.

PHP

The value returned by Code. Write PHP statements without opening or closing PHP tags and return a string or an image URL; do not use echo as a substitute for return.

  • Code — PHP statements that return the dynamic value.

Fields from Plugins

Custom field integrations add entries for the fields configured on your site. See Advanced Custom Fields, Meta Box, Toolset, and WooCommerce Dynamic Fields.

Choose the plugin-specific field when available to get its resolved value, such as an image instead of its stored attachment ID. Generic Custom Field entries read metadata by key.