Status Text: Tags

Overview

The following template tags can be inserted into a status’ text, either by:

  • Using the Insert Tag dropdown, displayed above the status message text field,
    WordPress to Buffer Pro: Tag Dropdown
  • Manually typing in the template tag into the status message text field.
Name Tag Description
Site Name {sitename} Displays your WordPress’ site name
Post Title {title} Displays the Post / Page / Custom Post Type Title
Post Excerpt (Full) {excerpt} Displays the full Post / Page / Custom Post Type Excerpt.
Post Excerpt (Character Limited) {excerpt_?} Displays the Post / Page / Custom Post Type Excerpt, limited to the given number of characters.
When using the Insert Tag dropdown, you’ll be asked for the number of characters to limit the Excerpt to, which replaces the question mark symbol in the Tag.
When manually typing in the template tag into the status message text field, you’ll need to replace the question mark symbol with the number of characters that you want to limit the Excerpt to.
Post Excerpt (Word Limited) {excerpt_?_words} Displays the Post / Page / Custom Post Type Excerpt, limited to the given number of words.
When using the Insert Tag dropdown, you’ll be asked for the number of words to limit the Excerpt to, which replaces the question mark symbol in the Tag.
When manually typing in the template tag into the status message text field, you’ll need to replace the question mark symbol with the number of words that you want to limit the Excerpt to.
Post Excerpt (Sentence Limited) {excerpt_?_sentence} Displays the Post / Page / Custom Post Type Excerpt, limited to the given number of sentences.
When using the Insert Tag dropdown, you’ll be asked for the number of sentences to limit the Excerpt to, which replaces the question mark symbol in the Tag.
When manually typing in the template tag into the status message text field, you’ll need to replace the question mark symbol with the number of sentences that you want to limit the Excerpt to.
Post Content (Full) {content} Displays the full Post / Page / Custom Post Type Content.
Post Content (Up to More Tag) {content_more_tag} Displays the Post / Page / Custom Post Type Content, up to the <!–more–> tag.  If no tag exists, this tag behaves as the Post Content (Full) tag.
Post Content (Character Limited) {content_?} Displays the Post / Page / Custom Post Type Content, limited to the given number of characters.
When using the Insert Tag dropdown, you’ll be asked for the number of characters to limit the Content to, which replaces the question mark symbol in the Tag.
When manually typing in the template tag into the status message text field, you’ll need to replace the question mark symbol with the number of characters that you want to limit the Content to.
Post Content (Word Limited) {content_?_words} Displays the Post / Page / Custom Post Type Content, limited to the given number of words.
When using the Insert Tag dropdown, you’ll be asked for the number of words to limit the Content to, which replaces the question mark symbol in the Tag.
When manually typing in the template tag into the status message text field, you’ll need to replace the question mark symbol with the number of words that you want to limit the Content to.
Post Content (Sentence Limited) {content_?_sentences} Displays the Post / Page / Custom Post Type Content, limited to the given number of sentences.
When using the Insert Tag dropdown, you’ll be asked for the number of sentences to limit the Content to, which replaces the question mark symbol in the Tag.
When manually typing in the template tag into the status message text field, you’ll need to replace the question mark symbol with the number of sentences that you want to limit the Content to.
Post Date {date} Displays the Post / Page / Custom Post Type Publish Date
Post URL {url} Displays the Post / Page / Custom Post Type URL
Post URL, Shortened {url_short} Displays the Post / Page / Custom Post Type shortened URL i.e. http://yoursite.com/?p=1
Post Meta Field {custom_field_NAME} Displays the Post / Page / Custom Post Type Custom Field Name’s value.  Replace NAME with the name of your Custom Field.  For example, a Custom Field called ‘test’ would use the template tag {custom_field_test}
Author Login {author_user_login} Displays the Post / Page / Custom Post Type’s Author’s Username
Author Nice Name {author_user_nicename} Displays the Post / Page / Custom Post Type’s Author’s Nice Name
Author Email {author_user_email} Displays the Post / Page / Custom Post Type’s Author’s Email Address
Author URL {author_user_url} Displays the Post / Page / Custom Post Type’s Author’s URL
Author Display Name {author_display_name} Displays the Post / Page / Custom Post Type’s Author’s Display Name
Author Meta Field {author_field_NAME} Displays the Post / Page / Custom Post Type Author Custom Field Name’s value.  Replace NAME with the name of your Custom Field.  For example, a Custom Field called ‘test’ would use the template tag {author_field_test}
Taxonomy: Category Hashtag {taxonomy_category} Displays a list of Categories assigned to the Post / Page / Custom Post Type.  Each Category is preceded with a hashtag, and each Category is separated by a space and converted to lowercase.  For example, a Post with the Categories One, Two and Three would output as #one #two #three
Taxonomy: Category Hashtag, Retaining Case {taxonomy_category_hashtag_retain_case} Displays a list of Categories assigned to the Post / Page / Custom Post Type.  Each Category is preceded with a hashtag, and each Category is separated by a space.  For example, a Post with the Categories One, Two and Three would output as #One #Two #Three
Taxonomy: Category Name {taxonomy_category_name} Displays a list of Categories assigned to the Post / Page / Custom Post Type.  Each Category is separated by a space.  For example, a Post with the Categories one, two and three would output as one two three
Taxonomy: Category Hashtag with Limit {taxonomy_category:2} Displays up to the given number of Categories assigned to the Post / Page / Custom Post Type.  Each Category is preceded with a hashtag, and each Category is separated by a space and converted to lowercase.  For example, a Post with the Categories One, Two and Three would output as #one #two
Taxonomy: Category Hashtag with Limit, Retaining Case {taxonomy_category_hashtag_retain_case:2} Displays up to the given number of Categories assigned to the Post / Page / Custom Post Type.  Each Category is preceded with a hashtag, and each Category is separated by a space.  For example, a Post with the Categories One, Two and Three would output as #One #Two
Taxonomy: Category Name with Limit {taxonomy_category_name:2} Displays a list of Categories assigned to the Post / Page / Custom Post Type.  Each Category is separated by a space.  For example, a Post with the Categories one, two and three would output as one two
Taxonomy: Tag Hashtag {taxonomy_post_tag} Displays a list of Tags assigned to the Post / Page / Custom Post Type.  EachTag is preceded with a hashtag, and each Tag is separated by a space and converted to lowercase.  For example, a Post with the Tags One, Two and Three would output as #one #two #three
Taxonomy: Category Hashtag, Retaining Case {taxonomy_post_tag_hashtag_retain_case} Displays a list of Tags assigned to the Post / Page / Custom Post Type.  Each Tag is preceded with a hashtag, and each Tag is separated by a space.  For example, a Post with the Tags One, Two and Three would output as #One #Two #Three
Taxonomy: Tag Name {taxonomy_post_tag_name} Displays a list of Tags assigned to the Post / Page / Custom Post Type.  EachTag is separated by a space.  For example, a Post with the Tags one, two and three would output as one two three
Taxonomy: Tag Hashtag with Limit {taxonomy_post_tag:2} Displays up to the given number of Tags assigned to the Post / Page / Custom Post Type.  EachTag is preceded with a hashtag, and each Tag is separated by a space.  For example, a Post with the Tags one, two and three would output as #one #two
Taxonomy: Category Hashtag with Limit, Retaining Case {taxonomy_post_tag_hashtag_retain_case:2} Displays up to the given number of Tags assigned to the Post / Page / Custom Post Type.  Each Tag is preceded with a hashtag, and each Tag is separated by a space.  For example, a Post with the Tags One, Two and Three would output as #One #Two
Taxonomy: Tag Name with Limit {taxonomy_post_tag_name:2} Displays a list of Tags assigned to the Post / Page / Custom Post Type.  Each Tag is separated by a space.  For example, a Post with the Tags one, two and three would output as one two
Depending on your WordPress web site, you may see additional Taxonomies if they are supported by the Post Type that you’re configuring status messages for.

Up to More Tag

If your Post Content contains a <!–more–> tag, you can use the {content_more_tag} to display the Post / Page / Custom Post Type Content, up to the <!–more–> tag.

If no tag exists, this tag behaves as the Post Content (Full) tag.

Character Limits

When adding Template Tags to status(es), a maximum character limit can be set by adding a number in brackets just before the closing Template Tag brace.  For example:

Name Tag Description
Post Title {title(50)} Displays the Post / Page / Custom Post Type Title, limited to a maximum of 50 characters.
Post Excerpt {excerpt(50)} Displays the Post / Page / Custom Post Type Excerpt, limited to a maximum of 50 characters.
Post Content {content(150)} Displays the Post / Page / Custom Post Type Content, limited to a maximum of 150 characters.

Character Limits can be used on any Template Tags except:

  • Post Date
  • Post URL
  • Post ID
  • Author Email
  • Author URL
  • Taxonomies

Word Limits

From 3.8.9, by default, Content and Excerpt tags will return their full content, with no truncation or word limits.  It’s therefore recommended that you use either a Word or Character Limit.

When adding Template Tags to status(es), a maximum word limit can be set by adding a number in brackets just before the closing Template Tag brace.  For example:

Name Tag Description
Post Title {title(50_words)} Displays the Post / Page / Custom Post Type Title, limited to a maximum of 50 words.
Post Excerpt {excerpt(50_words)} Displays the Post / Page / Custom Post Type Excerpt, limited to a maximum of 50 words.
Post Content {content(150_words)} Displays the Post / Page / Custom Post Type Content, limited to a maximum of 150 words.

Word Limits can be used on any Template Tags except:

  • Post Date
  • Post URL
  • Post ID
  • Author Email
  • Author URL
  • Taxonomies

Sentence Limits

When adding Template Tags to status(es), a maximum sentence limit can be set by adding a number in brackets just before the closing Template Tag brace.  For example:

Name Tag Description
Post Title {title(1_sentences)} Displays the Post / Page / Custom Post Type Title, limited to a maximum of 1 sentence.
Post Excerpt {excerpt(2_sentences)} Displays the Post / Page / Custom Post Type Excerpt, limited to a maximum of 2 sentences.
Post Content {content(3_sentences)} Displays the Post / Page / Custom Post Type Content, limited to a maximum of 3 sentences.

Sentence Limits can be used on any Template Tags except:

  • Post Date
  • Post URL
  • Post ID
  • Author Email
  • Author URL
  • Taxonomies

URL: Google Analytics UTM Parameters

To add Google Analytics UTM Parameters with a status text’s URL:

  • Add the parameters immediately after the {url} tag. For example:
    {url}?utm_source=source&utm_medium=medium&utm_campaign=campaign

All in One SEO Pack

When the All in One SEO Pack Plugin is installed and active, the following additional tags are available:

Name Tag Description
Meta Title {aioseo_meta_title} Displays the Post’s Meta Title, as it would be output in the <title> element
Meta Description {aioseo_meta_description} Displays the Post’s Meta Description, as it would be output in the <meta> element

The Events Calendar

When defining status(es) for Events in The Events Calendar, the following additional tags are available:

Name Tag Description
Event Start Date {tec_event_start_date} Displays the Event’s Start Date
Event Start Time {tec_event_start_time} Displays the Event’s Start Time
Event End Date {tec_event_end_date} Displays the Event’s End Date
Event End Time {tec_event_end_time} Displays the Event’s End Time
Event Cost {tec_event_cost} Displays the Event’s Cost
Event URL {tec_event_url} Displays a link to the Event URL.  Note: this is not the Event Post’s URL.
Event Map URL {tec_event_map_url} Displays a link to the location map

Events Manager

When defining status(es) for Events in Events Manager, the following additional tags are available:

Name Tag Description
Event Start Date {em_event_start_date} Displays the Event’s Start Date
Event Start Time {em_event_start_time} Displays the Event’s Start Time
Event End Date {em_event_end_date} Displays the Event’s End Date
Event End Time {em_event_end_time} Displays the Event’s End Time
Event Location {em_location} Displays the Event’s Location Name and Address
Event Location Name {em_location_name} Displays the Event’s Location Name
Event Location Address (Full) {em_location_address} Displays the full Event’s Location Address
Event Location Address {em_location_address_only} Displays the Event’s Location Address Line
Event Location Town {em_location_town} Displays the Event’s Location Address
Event Location State {em_location_state} Displays the Event’s Location State
Event Location Postcode {em_location_postcode} Displays the Event’s Location Postcode
Event Location Region {em_location_region} Displays the Event’s Location Region
Event Location Country {em_location_country} Displays the Event’s Location Country
Event Location URL {em_location_url} Displays the Event’s Location URL

Rank Math SEO

When the Rank Math SEO Plugin is installed and active, the following additional tags are available:

Name Tag Description
Meta Title {rank_math_meta_title} Displays the Post’s Meta Title, as it would be output in the <title> element
Meta Description {rank_math_meta_description} Displays the Post’s Meta Description, as it would be output in the <meta> element

SEOPress

When the SEOPress Plugin is installed and active, the following additional tags are available:

Name Tag Description
Meta Title {seopress_meta_title} Displays the Post’s Meta Title, as it would be output in the <title> element
Meta Description {seopress_meta_description} Displays the Post’s Meta Description, as it would be output in the <meta> element

Taxonomies

When using any taxonomy based template tag, such as {taxonomy_category}, you can optionally specify the maximum number of Terms that should be output on the status message.  This is useful if, for example, your Post has several Terms, and outputting all of them would result in a status message that is too long for a given social network.

To specify the maximum number of Terms, use the following format:

{taxonomy_category:n}

n is an integer number of the maximum number of Terms to output.  For example, if we wanted to output up to 2 Categories, we would use {taxonomy_category:2}

WooCommerce

When defining status(es) for Products in WooCommerce, the following additional tags are available:

Name Tag Description
Product Price {woocommerce_price} Displays the Product’s Price
Product Regular Price {woocommerce_regular_price} Displays the Product’s Regular Price
Product Sale Price {woocommerce_sale_price} Displays the Product’s Sale Price
Product Sale Price Date From {woocommerce_sale_date_from} Displays the Product’s Sale Price From Date
Product Sale Price Date To {woocommerce_sale_date_to} Displays the Product’s Sale Price To Date
Product SKU {woocommerce_sku} Displays the Product’s SKU
Product Quantity {woocommerce_quantity} Displays the Product’s Quantity
Product Weight {woocommerce_weight} Displays the Product’s Weight
Product Dimensions {woocommerce_dimensions} Displays the Product’s Dimensions
Product Average Rating {woocommerce_rating} Displays the Product’s Average Rating
Product Review Count {woocommerce_reviews} Displays the Product’s Review Count

Yoast SEO

When the Yoast SEO Pack Plugin is installed and active, the following additional tags are available:

Name Tag Description
Meta Title {yoast_seo_meta_title} Displays the Post’s Meta Title, as it would be output in the <title> element
Meta Description {yoast_seo_meta_description} Displays the Post’s Meta Description, as it would be output in the <meta> element

Shortcodes

Shortcodes can be used within the status text.

If your shortcode outputs HTML, this will be stripped out before the status is sent to Hootsuite.
If you’re using a PODS shortcode, you must include both the name and field attributes as a minimum.  For example, if your Post Type is called show and your PODS field is called line_up, you would use [pods name=”show” field=”line_up”]

Spintax

Spintax can be used within the status text, to help randomize the text content that’s output.

It’s best to think of spintax as a way of generating unique sentences, by specifying one or more words within a sentence, where each word has two or more choices.

Spintax Example

For example, a sentence might be:

Writing content is a lot of fun.

Using spintax, we can use:

{Writing|Creating} {content|articles} is a {lot of fun|rewarding experience}

WordPress to Hootsuite Pro will then, at random, generate a variation for the status text.  In this case there are 8 possible variations:

Writing content is a lot of fun
Creating content is a lot of fun
Writing articles is a lot of fun
Creating articles is a lot of fun
Writing content is a rewarding experience
Creating content is a rewarding experience
Writing articles is a rewarding experience
Creating articles is a rewarding experience

Spintax must contain two or more choices e.g. {Writing|Creating}.  Whilst e.g. {Writing} may validate in your own spintax validator, WordPress to Hootsuite Pro will treat this as a Status Tag, and not perform any spintax or removal of braces.

Nested Spintax Example

Spintax can also be nested.  For example:

{Hello|Hi}, {{Joe|Steve}|Tim|Tom}

WordPress to Hootsuite Pro will then, at random, generate a variation for the status text.  In this case there are 8 possible variations:

Hello, Joe
Hello, Steve
Hello, Tim
Hello, Tom
Hi, Joe
Hi, Steve
Hi, Tim
Hi, Tom

Using Tags

Tags can also be used within spintax.  For example:

{Written|Produced} by {{author_user_nicename}|{author_user_displayname}}

WordPress to Hootsuite Pro will then, at random, generate a variation for the status text.  In this case there are 8 possible variations (assuming the Author’s nicename = Steve and the Author’s Display Name = Steve Jobs):

Written by Steve
Written by Steve Jobs
Produced by Steve
Produced by Steve Jobs
Writing content is a rewarding experience