WordPress Data
In this article, you'll find a comprehensive list of available WordPress data field connection shortcodes. These shortcodes enable you to retrieve various types of data, including the title of your page or post, page or post content, publishing date, archive title, and more.
You can locate Field Connection shortcodes for our third-party integrations by following the links provided below.
WordPress data field connection shortcodes also support conditionals and expressions. Learn more by visiting the following links:
Archive
Archive Title
Outputs an archive's title.
[wpbb archive:title]
Archive Description
Outputs an archive's description.
[wpbb archive:description]
Archive Count
Outputs an archive's count. Example: (Showing 1-5 of 25.)
[wpbb archive:show_count]
Archive Page Count
Outputs an archive page count. Example: (Page 1 of 3.)
[wpbb archive:show_page_count]
Archive Term Meta
Outputs an archive’s meta term, such as the value of a custom field assigned to a taxonomy (a post category or tag or a custom taxonomy).
[wpbb archive:term_meta key='']
Author
Author Name
Outputs the authors name.
[wpbb post:author_name]
Options
- Type - Choices are display (default), first name, last name, first last, last first, nickname, and username.
- Link - Enable/Disable a link to the author's archive or to the website in the author's user profile.
Example
[wpbb post:author_name type='first' link='yes' link_type='website']
Author Bio
Outputs the author's bio (WordPress Dashboard > Users > Profile > Biographical Info).
[wpbb post:author_bio]
Author URL
Outputs the author's website or archive e.g. https://my-website.com/author/name/.
[wpbb post:author_url type='archive']
Options
- Type - Post Archive or Profile Website.
You can wrap the field connection shortcode with <a> tags to make a link.
<a href="[wpbb post:author_url type=archive]" title="Author Website">Author Website</a>
Author Picture
Outputs the authors profile picture.
[wpbb post:author_profile_picture link='no' link_type='archive' size='100']
Options
- Type - Choices are display (default), first name, last name, first last, last first, nickname, and username.
- Link - Enable/Disable a link to the author's archive or to the website in the author's user profile.
Example
[wpbb post:author_name type='first' link='yes' link_type='website']
Author Picture URL
Outputs the authors profile picture URL.
[wpbb post:author_profile_picture_url size='100']
Options
- Size - Set the pixel size of the image e.g. 100px.
Author Meta
Outputs the author’s meta term, such as the value of a custom field assigned to the user profile page.
[wpbb post:author_meta key='']
Comments
Comments Number
Outputs a post's comment number. Example: 21 Comments.
[wpbb post:comments_number link='yes' none_text='No Comments' one_text='1 Comment' more_text='% Comments']
Options
- Link - Enable/Disable link.
- No Comments Text - Set the text for when there are no comments. Default is "No Comments".
- One Comment Text - Set the text for when there is one comment. Default is "1 Comment".
- Comments Text - Set the text for when there are multiple comments. Default is "% Comments".
Comments URL
Outputs a post's comment URL. Example: https://my-website.com/hello-world/#respond
[wpbb post:comments_url]
Post/Page
The Post/Page field connections work for all public post types this includes custom post types.
Post Title
Outputs the post's title.
[wpbb post:title]
Post ID
Outputs the post's ID.
[wpbb post:id]
Post Excerpt
Outputs the post excerpt.
[wpbb post:excerpt length='55' more='']
Options
- Length - Accepts a number (number of words). Default is 55.
- More - Accepts text to appear after the excerpt
Example
[wpbb post:excerpt length='100' more='Continue Reading']
Post Content
Outputs the post's content.
[wpbb post:content]
Post Custom Field
Outputs WordPress custom fields added to the page, post or custom post type.
[wpbb post:custom_field key='']
Options
- Key - Your custom field key
Example
[wpbb post:custom_field key='blue']
Post Link
Outputs the post's Link.
[wpbb post:link text='title']
Options
- Link Text - Choice of Post Title or Custom.
Example
[wpbb post:link text='custom' custom_text='Read More...']
Post URL
Outputs the post's URL. Example: https://my-website.com/hello-world/.
[wpbb post:url]
Post Slug
Outputs the post's slug. Example: hello-world.
[wpbb post:slug]
Post Type
Outputs the post types name, singular name, or slug. Example: post.
[wpbb post:post_type display='slug']
Options
- Display - Choices are Slug, Singular Same, Name, or No Posts Found.
This field connection comes in handy when you're utilizing a Post module that's set up to showcase various post types and you wish to apply distinct styling to individual elements based on the post type.
See the Expression Examples article for more details.
Post Date
See the PHP date() document for a list of date formats or use the Insert functionality in the Beaver Builder UI to choose from a list of date formats when you insert this field connection.
[wpbb post:date format='']
Options
- Format - Accepts date formats
Example
[wpbb post:date format='F j, Y']Output
December 25, 2021
Post Modified Date
See the PHP date() document for a list of date formats or use the Insert functionality in the Beaver Builder UI to choose from a list of date formats when you insert this field connection.
[wpbb post:modified_date format='']
Options
- Format - Accepts date formats.
Example
[wpbb post:modified_date format='F j, Y']
Post Featured Image
Outputs the post's featured image.
[wpbb post:featured_image size='thumbnail' display='tag' align='left' linked='yes']
Options
- Size - Thumbnail, Medium, Large, Full Size and any custom sizes you have.
- Display - Image Tag (
<img>), URL, Title, Caption, Description or Alt. - Align - default, left, center, right.
- Linked - Enable or disable the link on the featured image.
Example
[wpbb post:featured_image size='medium' display='tag' align='center' linked='yes']
Post Attached Image
Outputs any images attached to the post.
This field connection only appears in modules that have a gallery field setting, such as the Gallery or Slideshow modules.
[wpbb post:attached_images]
Post Terms List
Outputs the post's terms assigned to the post type you are editing.
[wpbb post:terms_list taxonomy='category' html_list='no' display='name' separator=', ' limit= linked='yes']
Options
Taxonomy (
taxonomy='')
Displays the taxonomy terms assigned to the post type your Themer layout applies to.
Examples: For standard posts, the terms are Categories and Tags. For WooCommerce Products, the terms are Product Categories and Product Tags.Layout (
html_list='')
Choose how the terms are displayed from Separator, Unordered List (<ul>), Ordered List (<ol>), Div/Span (<span>).
The list layouts are not hierarchical. For example, if you have both parent and child categories selected for posts, they will appear at the same level in the list layout.
Display (
display='')
Choose how the terms are displayed from Name, or Slug.Separator (
separator='')
Leave blank or add in something to separate the terms (if Layout is set to Separator). Default is comma (,).Limit (
limit='')
Limit the number of terms returned.Linked (
linked='')
Enable or disable the link to the taxonomy term.
Example
[wpbb post:terms_list taxonomy='category' html_list='no' display='name' separator='* ' limit='5' linked='yes']
Site
Site Title
Outputs the site's title from the WordPress Customizer.
[wpbb site:title]
Site Tagline
Outputs the site's tagline from the WordPress Customizer.
[wpbb site:tagline]
Site URL
Outputs the site's URL.
[wpbb site:url]
Current Year
Outputs the site's year. Useful for adding a dynamic year in footer layouts.
[wpbb site:year format='Y']
Example:
Copyright © 2010 - [wpbb site:year format='Y'] My Company Name.Output:
© 2010 - 2023 My Company Name.
User
User Name
Outputs the user's name.
[wpbb site:user_name type='display' link='yes' user='current']
Options
- Type - Choices are Display Name (Default), First Name, Last Name, First & Last Name, Last, First Name, Nickname, and Username.
- Link - Enable/Disable a link to the user's archive or to the website in the user profile.
- Link_type - Post Archive or Profile Website (if Link set to yes).
- User - Current or Specific
- User ID Enter the User ID number (if User is set to Specific).
Example
[wpbb site:user_name type='display' link='yes' link_type='archive' user='specific' user_id='1']
User Bio
Outputs the user's bio (WordPress Dashboard > Users > Profile > Biographical Info).
[wpbb site:user_bio user=current user_id='']
Options
- User - Current, Specific
- User ID - User ID number (if User set to Specific).
Example
[wpbb site:user_bio user='specific' user_id='2']
User URL
Outputs the user's URL. Example: https://my-website.com/author/name/.
[wpbb site:user_url type='archive' user='current']
Options
- Type - Post Archive or Profile Website
- User - Current or Specific
- User ID Enter the User ID number (if User is set to Specific).
Example
[wpbb site:user_url type='website' user='specific' user_id='1']
User Picture
[wpbb site:user_profile_picture link='yes' size='300' user='current']
Options
- Link - Yes or No.
- Link Type - Post Archive or Users Profile Website
- Size - Image Size in pixels (px).
- User - Current or Specific
- User ID - User ID number (if User set to Specific).
Example
[wpbb site:user_profile_picture link='yes' link_type='archive' size='300' user='specific' user_id='5']
User Meta
Outputs the user's meta term, such as the value of a users profile setting or custom field assigned to a user profile.
[wpbb site:user_meta key=?? user=current user_id=??]
Options
- Key - User Meta key value
- User - Current or Specific
- User ID - User ID number (if User set to Specific).
Example
This is an example using WooCommerce meta terms to output the user's company from the Customer billing address.
[wpbb site:user_meta key='billing_company' user='specific' user_id='5']
User Logged In
This shortcode returns True (1) or False (0) and is used mostly as a conditional shortcode.
[wpbb site:logged_in role='' user='current' user_id='']
Options
- Role/Roles - User role, in lower case. Separate multiple roles with commas.
- User - Current or Specific
- User ID - User ID number (if User set to Specific).
Example
[wpbb-if site:logged_in role='administrator' user='current']
Display this message if currently logged-in user has role Administrator.
[/wpbb-if]