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.

info

You can locate Field Connection shortcodes for our third-party integrations by following the links provided below.

tip

WordPress data field connection shortcodes also support conditionals and expressions. Learn more by visiting the following links:

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.

Tip

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.

tip

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.

info

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>).

info

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']

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]

Archive​

Archive Title​

Archive Description​

Archive Count​

Archive Page Count​

Archive Term Meta​

Author​

Author Name​

Author Bio​

Author URL​

Author Picture​

Author Picture URL​

Author Meta​

Comments​

Comments Number​

Comments URL​

Post/Page​

Post Title​

Post ID​

Post Excerpt​

Post Content​

Post Custom Field​

Post Link​

Post URL​

Post Slug​

Post Type​

Post Date​

Post Modified Date​

Post Featured Image​

Post Attached Image​

Post Terms List​

Site​

Site Title​

Site Tagline​

Site URL​

Current Year​

User​

User Name​

User Bio​

User URL​

User Picture​

User Meta​

User Logged In​

Archive

Archive Title

Archive Description

Archive Count

Archive Page Count

Archive Term Meta

Author

Author Name

Author Bio

Author URL

Author Picture

Author Picture URL

Author Meta

Comments

Comments Number

Comments URL

Post/Page

Post Title

Post ID

Post Excerpt

Post Content

Post Custom Field

Post Link

Post URL

Post Slug

Post Type

Post Date

Post Modified Date

Post Featured Image

Post Attached Image

Post Terms List

Site

Site Title

Site Tagline

Site URL

Current Year

User

User Name

User Bio

User URL

User Picture

User Meta

User Logged In