Status Settings

Status Settings define the status(es) to automatically send to your social media account(s) linked with your SocialPilot account, depending on the Post Action being performed on a Post, Page or Custom Post Type (for example, whether a Post is first published, or an existing published Page is updated).

For each Post Type, WordPress to SocialPilot Pro provides options to:

  • Define Default status messages, depending on the Post Action being performed on the Post.
  • Choose which Social Media account(s) to send content to
  • Optionally define social media account specific status messages, which override the Default status messages

To set your status messages, in the WordPress Administration, click on the WP to SocialPilot Pro > Settings in the menu.

Post Types

Depending on your theme and plugins, additional tabs may appear as well as the default Posts and Pages tabs. These additional tabs will be registered Custom Post Types.
WordPress to SocialPilot Pro: Status Settings: Post Type Tabs

To edit the status updates to be sent to SocialPilot for a given Post Type, click the relevant tab.

For each Post Type, you’ll see each of your SocialPilot social media profiles, as well as a Defaults tab, listed on the left of the screen.

It’s important to go through each tab to define the settings you’ll need.

WordPress to SocialPilot Pro: Status Settings: Post Type Tabs

  • Defaults: Global settings that apply to enabled social media accounts.
  • Social Media Accounts: Each social media account linked to your SocialPilot account will be displayed here, one account per tab. Clicking a tab will provide options to enable posting to said social media account, as well as an option to override the default Defaults tab above.
    • Account Enabled: Tick this checkbox if you want to send status updates to this social media profile.
    • Override Defaults: Tick this checkbox if you want to specify a custom set of status updates for this specific social media profile.  If this checkbox is not ticked, the settings on the Defaults tab will be used.
It is not enough to just define the Defaults.  You must ALSO click on each Social Media Account tab, choosing whether to enable that Account.  If you do not, no statuses will be sent to SocialPilot.

When clicking on either the Defaults tab, or a Social Media Profile, status settings are split into four actions:

Post Action Description
Publish Statuses defined here will be sent to SocialPilot for scheduled posting to the chosen social networks, when a new WordPress Post is published.
Update Statuses defined here will be sent to SocialPilot for scheduled posting to the chosen social networks, when an existing published WordPress Post is updated.
Repost Statuses defined here will be sent to SocialPilot for scheduled posting to the chosen social networks, when an existing WordPress Post meets the criteria for reposting.
Bulk Publish Statuses defined here will be sent to SocialPilot for scheduled posting to the chosen social networks, when an existing WordPress Post is manually chosen by the user through the Bulk Publish screen.

To define the status(es) to send to SocialPilot for a particular action, click that action tab:
WordPress to SocialPilot Pro: Status Settings: Profile Actions

Post Action: Publish

WordPress to SocialPilot Pro: Status Settings: Enabled Status

  • Enabled: Tick this checkbox if you want to send a status update to your SocialPilot account when a Post, Page or Custom Post Type is published.  This also applies to scheduled Posts, Pages and Custom Post Types.
  • Add Status Update: Click this button to add an additional status update.  You can have as many status updates as you wish, but each must be unique to ensure SocialPilot and the social networks don’t reject them.

For each status update, the following options are available:

  • Insert Tag: Use this to select a template tag to insert into the status.
  • Image: Depending on the social network you’re defining a status for, up to three options are available here, which determine if and how a Featured Image is displayed with the status update.
    Refer to the Featured Image Documentation for a detailed breakdown and preview of how this setting operates.
  • Status: The main text to send for the status update.
  • Scheduling: Define how the status should be scheduled for publication to your social media profiles.
  • Conditions: Conditionally send the status to SocialPilot if certain criteria are / are not met.

Post Action: Update

The Update Post Action is triggered when an existing published Post is updated (that is, a WordPress User modifies the Post by clicking Update).

Any status(es) defined within the Update tab of either your Defaults, or a specific Social Media Profile, will be used when an existing published Post is updated.

Settings in the Update panel are the same as the Publish section above.


Post Action: Repost

The Repost Post Action is triggered when an existing published Post, that has not been updated for a while, is selected by the Plugin for automatic re-sending to SocialPilot.

Any status(es) defined within the Repost tab of either your Defaults, or a specific Social Media Profile, will be used .

Settings in the Repost panel are the same as the Publish section above.

Refer to the Repost Documentation to understand how reposting works, and where to define the conditions that determine which published Post(s) should be automatically re-posted to SocialPilot.


Post Action: Bulk Publish

Any status(es) defined within the Bulk Publish tab of either your Defaults, or a specific Social Media Profile, will be used when you manually use the Plugin’s Bulk Publish functionality.

Settings in the Bulk Publish panel are the same as the Publish section above.

Refer to the Bulk Publish Documentation to understand how to manually Bulk Publish Posts to SocialPilot.


Status Text: Tags

The following template tags can be inserted into status updates, 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 {excerpt} Displays the Post / Page / Custom Post Type Excerpt.
Post Content {content} Displays the Post / Page / Custom Post Type Content.
Post Date {date} Displays the Post / Page / Custom Post Type Publish Date
Post URL {url} Displays the Post / Page / Custom Post Type URL
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.  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.  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.  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: 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.

Status Text: Tags: 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

Status Text: Tags: Word Limits

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

Status Text: Tags: 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

Status Text: Tags: 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

Status Text: Tags: 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}

Status Text: Tags: 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 Price {woocommerce_regular_price} Displays the Product’s Regular Price
Product Price {woocommerce_sale_price} Displays the Product’s Sale Price
Product Price {woocommerce_sale_date_from} Displays the Product’s Sale Price From Date
Product Price {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

Status Text: Tags: 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

Status Text: 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 SocialPilot.
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”]

Status Text: Scheduling

WordPress to SocialPilot Pro: Status: Schedule: Options

For each defined status, several options are available to define where (and when) a status should appear in your SocialPilot queue:

Add to End of SocialPilot Queue

Adds the status update to the end of the social media profile’s queue.

Post Immediately

Posts the status update to your social media profiles when the Post is published.

Custom Time

WordPress to SocialPilot Pro: Status: Schedule: Custom Time

Allows you to schedule the status on SocialPilot for a given offset in days, hours and minutes after your Post is published.

For example, to schedule a status update on SocialPilot to be sent to your to social media profiles 2 days after your Post is published:

  • Days: 2
  • Hours: 0
  • Minutes: 0

Custom Time (based on Custom Field / Post Meta Value)

WordPress to SocialPilot Pro: Status: Schedule: Custom Time Field

Allows you to schedule the status on SocialPilot for a given offset in days, hours and minutes relative to the Post’s Custom Field / Meta Field.

For example, to send a status update to social media profiles 2 days after the date given in your Post’s Custom Field called event_date:

  • Days: 2
  • Hours: 0
  • Minutes: 0
  • Before / After: After Custom Field Value
  • Custom Meta Field Name: event_date

For example, to send a status update to social media profiles 12 hours before the date given in your Post’s Custom Field called my_date:

  • Days: 0
  • Hours: 12
  • Minutes: 0
  • Before / After: Before Custom Field Value
  • Custom Meta Field Name: my_date
When using the Custom Field (based on Custom Field / Post Meta Value) option, the date value in your Post’s Custom Field must be in the format yyyy-mm-dd.

The Events Calendar: Relative to Event Start Date

WordPress to SocialPilot Pro: Status: Schedule: Event Start Date

This option is only available if The Events Calendar Plugin is installed and activated on your WordPress web site, and you are editing status settings for Events.

Allows you to schedule the status on SocialPilot for a given offset in days, hours and minutes relative to The Event Calendar Event’s Start Date.

For example, to send a status update to social media profiles 12 hours before an Event’s Start Date:

  • Days: 0
  • Hours: 12
  • Minutes: 0
  • Before / After: Before Event Date

The Events Calendar: Relative to Event End Date

WordPress to SocialPilot Pro: Status: Schedule: Event End Date

This option is only available if The Events Calendar Plugin is installed and activated on your WordPress web site, and you are editing status settings for Events.

Allows you to schedule the status on SocialPilot for a given offset in days, hours and minutes relative to The Event Calendar Event’s End Date.

For example, to send a status update to social media profiles 2 days before an Event’s End Date:

  • Days: 2
  • Hours: 0
  • Minutes: 0
  • Before / After: Before End Date

Specific Date and Time

WordPress to SocialPilot Pro: Status: Schedule: Specific Date and Time

This option is only available when defining status messages at Post level.  Refer to the Documentation on how to do this.

Allows you to schedule the status on SocialPilot for the given date and time.

Status: Re-Order Status Updates

To re-order a status updates, drag and drop them by clicking the number in the circle.

Status: Delete Status Updates

To delete a status update, click the bin icon below the number in the circle.

Status: Conditions: Dates

For each status update, you can conditionally choose to send the status to SocialPilot based on whether a Post falls between two given dates.

This is useful if, for example:

  • You only want to send statuses for Posts in a specific month (or months),
  • You want to define multiple statuses, each with different text, but only have one status send depending on the Post’s date.
Conditions work in conjunction with each other.  For example, if you only want to send statuses on a specific season, you can define dates here as well as a Category that’s required for the status to be sent to SocialPilot.

To define date conditions for a status update, complete the following fields:
WordPress to SocialPilot Pro: Status: Conditions: Dates

  • Start Date:
    • Enter the day, as a number
    • Choose a month
  • End Date
    • Enter the day, as a number
    • Choose a month

To remove date conditions:

  • Leave the Day fields blank
  • Select Any Month from the Month dropdowns

Status: Conditions: Taxonomies

For each status update, you can conditionally choose to send the status to SocialPilot based on whether a Post has (or does not have) specific Taxonomy Terms (categories, tags etc).

This is useful if, for example:

  • You want to send different status updates for a Post depending on the Post Category,
  • You do not want to send status updates for a Post belonging to a specific Category,
  • You want to send different status updates to different Pinterest boards depending on the Post Category

To define conditions for a status update, click on the Conditions: Taxonomies arrow to display available options:
WordPress to SocialPilot Pro: Status: Conditions: Taxonomies

  • Comparison: Choose a comparison method
    • No Conditions
      Do not apply any conditions to this status update for the given Taxonomy.
    • Post(s) must include ANY of the below Taxonomy Terms to send this status to SocialPilot
      The Post must have at least one of the Taxonomy Terms you specify, for the status update to be sent to SocialPilot.
    • Post(s) must include ALL of the below Taxonomy Terms to send this status to SocialPilot
      The Post must have all of the Taxonomy Terms you specify, for the status update to be sent to SocialPilot.
    • Post(s) must exclude ANY of the below Taxonomy Terms to send this status to SocialPilot
      The Post must not have any of the Taxonomy Terms you specify.  If the Post does contain one or more of the Taxonomy Terms you specify, the status update will not be sent to SocialPilot.
  • Terms
    • In the text input below the Comparison dropdown option, start typing the Taxonomy Term Name(s) that you require for this condition.
    • As you start typing, your existing Taxonomy Term Name(s) will appear in the list.  Click on a term to add it.
      WordPress to SocialPilot Pro: Status Settings: Conditions
    • To remove an existing Taxonomy Term, click the small cross to the left of the term
      WordPress to SocialPilot Pro: Status Settings: Conditions

Click Save to update your settings.

Status: Conditions: Custom Fields

For each status update, you can conditionally choose to send the status to SocialPilot based on whether a Post has (or does not have) Custom Field Values (sometimes referred to as Meta Key values).  More than one rule can be specified per status, and each rule can have different comparison operators for the same or different Custom Fields.

This is useful if, for example:

  • You want to send different status updates for a Post depending on the value of a Custom Field, such as an Advanced Custom Field value or meta key value,
  • You do not want to send status updates for a Post where a meta key value is missing (such as your SEO Plugin’s Title field)

To define conditions for a status update, click on the Conditions: Custom Fields arrow to display the table:
WordPress to SocialPilot Pro: Status: Conditions: Custom Fields Table

  • To add additional conditions, click the Add Meta  / Custom Field Condition button.
  • To remove an existing condition, click the Remove button for the row you want to remove.

For each condition, the following options are available:

  • Key: The Custom Field (meta key) to inspect
  • Compare: The method used to compare the Post’s custom field value to the Value below.
  • Value: The value to compare.

For example, to only have a status be sent to SocialPilot when the Custom Field yoast_seo_title has any value:

  • Key: yoast_seo_title
  • Compare: Does Not Equal
  • Value: (leave blank)

WordPress to SocialPilot Pro: Status: Conditions: Custom Fields Table: Yoast Example

For example, to only have a status be sent to SocialPilot when the Custom Field price is greater than 10, and the Custom Field quantity is greater than or equal to 1:

  • Key: price
  • Compare: Greater Than
  • Value: 10
  • Key: quantity
  • Compare: Greater Than or Equal To
  • Value: 1

WordPress to SocialPilot Pro: Status: Conditions: Custom Fields Table: Example

Click Save to update your settings.

Once you have completed the Plugin setup, a green tick will be displayed on each Post Type, Social Media Account and Action tab, to identify which are enabled for sending statuses to SocialPilot.