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,
- 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
There are two ways to include 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 - If you’ve a Buffer Business Plan, you can define the parameters within Buffer itself (that is, buffer.com):
https://buffer.com/library/utm-guide/#quick-recap-on-utm-parameters-in-social-media
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 |
| Event Venue Address (Full) | {tec_event_venue_address} | Displays the Event Venue’s full Address |
| Event Venue Address Only | {tec_event_venue_address_only} | Displays the Event Venue’s Address Line |
| Event Venue City | {tec_event_venue_city} | Displays the Event Venue’s City |
| Event Venue State or Province | {tec_event_venue_province} | Displays the Event Venue’s State or Province |
| Event Venue Postal Code | {tec_event_venue_postal_code} | Displays the Event Venue’s Postal Code |
| Event Venue Country | {tec_event_venue_country} | Displays the Event Venue’s Country |
| Event Organizer Name | {tec_event_organizer_name} | Displays the Event Organizer’s Name |
| Event Organizer Phone | {tec_event_organizer_phone} | Displays the Event Organizer’s Phone Number |
| Event Organizer Email | {tec_event_organizer_email} | Displays the Event Organizer’s Email Address |
| Event Organizer Website URL | {tec_event_organizer_website_url} | Displays the Event Organizer’s Website URL |
Events Manager
Some Events Manager tags are available in WordPress to Buffer Pro 4.3.8 and higher, releasing Thursday 26th November 2020 23:59 GMT. Ensure that your license is valid, not expired and that you’ve updated to the latest version of the Plugin.
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
Rank Math SEO tags are available in WordPress to Buffer Pro 4.3.8 and higher, releasing Thursday 26th November 2020 23:59 GMT. Ensure that your license is valid, not expired and that you’ve updated to the latest version of the Plugin.
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 Buffer.
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 Buffer 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 Buffer 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 Buffer 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 Buffer 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