{"id":9341,"date":"2017-12-14T19:47:53","date_gmt":"2017-12-15T00:47:53","guid":{"rendered":"http:\/\/publishpress.net\/?post_type=knowledgebase&#038;p=9341"},"modified":"2025-07-04T12:48:04","modified_gmt":"2025-07-04T16:48:04","password":"","slug":"customize-email-notifications","status":"publish","type":"docs","link":"https:\/\/publishpress.com\/knowledge-base\/customize-email-notifications\/","title":{"rendered":"Customize Content in Planner Notifications"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">The <a href=\"https:\/\/publishpress.com\/links\/planner\" class=\"tinypress-autolink\" title=\"PublishPress Planner\">PublishPress Planner<\/a> plugin allows you to customize the notifications that are sent out.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The text of the notifications is controlled from the\u00a0&#8220;What to say?&#8221; area of each notification workflow.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/publishpress.com\/links\/planner\" class=\"tinypress-autolink\" title=\"PublishPress Planner\">PublishPress Planner<\/a> shortcodes can be dropped directly into the Subject or Body. The image below has an example of notification shortcodes in action:<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter\"><img loading=\"lazy\" decoding=\"async\" width=\"641\" height=\"448\" src=\"https:\/\/publishpress.com\/wp-content\/uploads\/2017\/12\/notification-example.png\" alt=\"Planner notifications\" class=\"wp-image-15623\" srcset=\"https:\/\/publishpress.com\/wp-content\/uploads\/2017\/12\/notification-example.png 641w, https:\/\/publishpress.com\/wp-content\/uploads\/2017\/12\/notification-example-300x210.png 300w\" sizes=\"auto, (max-width: 641px) 100vw, 641px\" \/><\/figure>\n<\/div>\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\">\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-shortcodes-for-content\">Shortcodes for Content<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">These shortcodes will show details from the content that triggers the notification.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This is the most basic shortcode, which will show the title of the post:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_post]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">You can add fields to this shortcode. For example, you can add &#8220;title&#8221;. This will also show the title of the post:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_post title]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Here are more fields you can use inside your content notifications:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>[psppno_post content]<\/code> shows the content of the post. This option may be messy because of the code produced by some page-builders.<\/li>\n\n\n\n<li><code>[psppno_post excerpt]<\/code> shows the excerpt of the post.<\/li>\n\n\n\n<li><code>[psppno_post post_type]<\/code> shows the post type of the post.<\/li>\n\n\n\n<li><code>[psppno_post id]<\/code> shows the ID number of the post.<\/li>\n\n\n\n<li><code>[psppno_post permalink]<\/code> shows the URL of the post.<\/li>\n\n\n\n<li><code>[psppno_post date]<\/code> shows the publishing date of the post. If the post is scheduled, this will show the future publishing date.<\/li>\n\n\n\n<li><code>[psppno_post time]<\/code> shows the publishing time of the post.<\/li>\n\n\n\n<li><code>[psppno_post old_status]<\/code> shows the previous status, before the post was saved.<\/li>\n\n\n\n<li><code>[psppno_post new_status]<\/code> shows the updated status, after the post was saved.<\/li>\n\n\n\n<li><code>[psppno_post edit_link]<\/code> shows a link to edit the post in the WordPress admin.<\/li>\n\n\n\n<li><code>[psppno_post author_display_name]<\/code> shows the Display Name of the post&#8217;s author.<\/li>\n\n\n\n<li><code>[psppno_post author_email]<\/code> shows the author&#8217;s email.<\/li>\n\n\n\n<li><code>[psppno_post author_login]<\/code> shows the author&#8217;s login name.<\/li>\n\n\n\n<li><code>[psppno_revision permalink]<\/code> shows the URL of the revision.<\/li>\n\n\n\n<li><code>[psppno_revision edit_link]<\/code> shows a link to edit the revision in the WordPress admin.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\">\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-shortcodes-for-the-author\">Shortcodes for the Author<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">These shortcodes will display information about the author of the content that triggers the notification.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This is the most basic shortcode, which will show the Display Name of the author:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_actor]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">You can add fields to this shortcode. For example, you can add &#8220;display_name&#8221;. This will also show the Display Name of the author:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_actor display_name]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Here are more author fields you can use inside your content notifications:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>[psppno_actor email]<\/code> shows the author&#8217;s email address.<\/li>\n\n\n\n<li><code>[psppno_actor id]<\/code> shows the author&#8217;s ID number.<\/li>\n\n\n\n<li><code>[psppno_actor login]<\/code> shows the author&#8217;s login name.<\/li>\n\n\n\n<li><code>[psppno_actor url]<\/code> shows the website URL.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\">\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-shortcodes-for-editorial-comments\">Shortcodes for Editorial Comments<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">These shortcodes will show information about the <a href=\"https:\/\/publishpress.com\/knowledge-base\/editorial-comments\/\">editorial comment<\/a> that triggers the notification.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This is the most basic shortcode, which will show the content of the comment:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_edcomment]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">You can add fields to this shortcode. For example, you can add &#8220;content&#8221;. This will also show the content of the comment:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_edcomment content]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Here are more editorial comment fields you can use inside your content notifications:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>[psppno_edcomment author]<\/code> shows of the Display Name user who wrote the comment.<\/li>\n\n\n\n<li><code>[psppno_edcomment author_email]<\/code> shows the email of the user who wrote the comment.<\/li>\n\n\n\n<li><code>[psppno_edcomment author_url]<\/code> shows the URL of the user who wrote the comment.<\/li>\n\n\n\n<li><code>[psppno_edcomment ip]<\/code> shows of the IP address of the user who wrote the comment.<\/li>\n\n\n\n<li><code>[psppno_edcomment date]<\/code> shows of the date and time of the comment.<\/li>\n\n\n\n<li><code>[psppno_edcomment id]<\/code> shows the ID number of the comment.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\">\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-shortcodes-for-post-metadata\">Shortcodes for post metadata<\/h2>\n\n\n\n<p class=\"pro-feature-box-disabled wp-block-paragraph\">This feature requires the Pro version of the PublishPress Planner plugin.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The Pro version of the PublishPress Planner plugin supports post meta in notifications.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can find the metadata for these shortcodes in the <strong>_postmeta<\/strong> table in your database.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The PublishPress Planner plugin has it&#8217;s <a href=\"https:\/\/publishpress.com\/knowledge-base\/editorial-metadata\/\">own metadata fields<\/a>. This is the syntax you  can use for a text field called &#8220;Penguins&#8221;.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_post meta:_pp_editorial_meta_text_penguins]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">This is the syntax you can use for a date field called &#8220;Penguin Birthday&#8221;:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_post meta:_pp_editorial_meta_date_penguin_birthday]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">You can use any kind of post metadata for notifications, including data from third party plugins.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For example, if you&#8217;re really focused on SEO, you can include the Yoast SEO metadata for each post in your notifications. This is screenshot from the _postmeta table, showing some of the Yoast SEO data for a single post:<\/p>\n\n\n\n<figure class=\"wp-block-image is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"184\" src=\"https:\/\/publishpress.com\/wp-content\/uploads\/2019\/08\/yoast-keywords-metadata-1024x184.png\" alt=\"Planner notifications with metadata\" class=\"wp-image-37767\" style=\"width:800px\" srcset=\"https:\/\/publishpress.com\/wp-content\/uploads\/2019\/08\/yoast-keywords-metadata-1024x184.png 1024w, https:\/\/publishpress.com\/wp-content\/uploads\/2019\/08\/yoast-keywords-metadata-300x54.png 300w, https:\/\/publishpress.com\/wp-content\/uploads\/2019\/08\/yoast-keywords-metadata-768x138.png 768w, https:\/\/publishpress.com\/wp-content\/uploads\/2019\/08\/yoast-keywords-metadata.png 1728w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Using the information in the image above, here&#8217;s how you can include the Yoast SEO title in each notification:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_post meta:_yoast_wpseo_title]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Here&#8217;s how you can include the Yoast SEO Content Score in each notification:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_post meta:_yoast_wpseo_content_score]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Here&#8217;s how you can include the Yoast SEO meta description in each notification:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_post meta:_yoast_wpseo_metadesc]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Let me show you an example of how this works in practice. We created a notification that looks like this:<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"436\" src=\"https:\/\/publishpress.com\/wp-content\/uploads\/2019\/08\/notification-with-yoast-1024x436.png\" alt=\"Planner notifications\" class=\"wp-image-37854\" style=\"width:768px;height:327px\" srcset=\"https:\/\/publishpress.com\/wp-content\/uploads\/2019\/08\/notification-with-yoast-1024x436.png 1024w, https:\/\/publishpress.com\/wp-content\/uploads\/2019\/08\/notification-with-yoast-300x128.png 300w, https:\/\/publishpress.com\/wp-content\/uploads\/2019\/08\/notification-with-yoast-768x327.png 768w, https:\/\/publishpress.com\/wp-content\/uploads\/2019\/08\/notification-with-yoast.png 1174w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n<\/div>\n\n\n<p class=\"wp-block-paragraph\">Now every time a post is published on our site, we get a notification that looks like this:<\/p>\n\n\n\n<figure class=\"wp-block-image is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"198\" src=\"https:\/\/publishpress.com\/wp-content\/uploads\/2019\/08\/notification-email-metadata-1024x198.png\" alt=\"\" class=\"wp-image-37855\" style=\"width:768px;height:149px\" srcset=\"https:\/\/publishpress.com\/wp-content\/uploads\/2019\/08\/notification-email-metadata-1024x198.png 1024w, https:\/\/publishpress.com\/wp-content\/uploads\/2019\/08\/notification-email-metadata-300x58.png 300w, https:\/\/publishpress.com\/wp-content\/uploads\/2019\/08\/notification-email-metadata-768x149.png 768w, https:\/\/publishpress.com\/wp-content\/uploads\/2019\/08\/notification-email-metadata.png 1446w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\">\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-shortcodes-for-the-notification\">Shortcodes for the Notification <\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">These shortcodes will show information about the notification itself.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This is the most basic shortcode, which will show the name of the workflow:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_workflow]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">You can add fields to this shortcode. For example, you can add &#8220;title&#8221;. This will also show the name of the workflow:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_workflow title]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The other option is to show the ID number of the workflow:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_workflow id]<\/code><\/pre>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\">\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-shortcodes-for-the-notification-receiver\">Shortcodes for the Notification Receiver<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">These shortcodes will show information about the user receiving the notification.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This is the most basic shortcode, which will show the name of the person receiving the notification: <\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_receiver]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">You can add fields to this shortcode. For example, you can add &#8220;name&#8221;. This will also show the name of the receiver:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_receiver name]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The other option is to show the email address of the receiver:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[psppno_receiver email]<\/code><\/pre>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\">\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-how-to-use-multiple-shortcode-fields-together\">How to Use Multiple Shortcode Fields Together<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">To display multiple fields in a shortcode, simply list the fields with a space to separate them:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[shortcode field1 field2 field3]<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"<p>The <a href=\"https:\/\/publishpress.com\/links\/planner\" class=\"tinypress-autolink\" title=\"PublishPress Planner\">PublishPress Planner<\/a> plugin allows you to customize the notifications that are sent out. The text of the notifications is controlled from the\u00a0\u201cWhat to say?\u201d area of each notification workflow. <a href=\"https:\/\/publishpress.com\/links\/planner\" class=\"tinypress-autolink\" title=\"PublishPress Planner\">PublishPress Planner<\/a> shortcodes can be dropped directly into the Subject or Body. The image below has an example of notification shortcodes in action: Shortcodes for&#8230;<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_seopress_titles_title":"","_seopress_titles_desc":"The PublishPress Planner plugin allows you to customize the notifications that are sent out for content changes.","_seopress_robots_index":"","_seopress_robots_follow":"","_seopress_robots_imageindex":"","_seopress_robots_snippet":"","_seopress_robots_primary_cat":"","_seopress_robots_breadcrumbs":"","_seopress_robots_freeze_modified_date":"","_seopress_robots_custom_modified_date":"","_seopress_robots_canonical":"","_seopress_social_fb_title":"","_seopress_social_fb_desc":"","_seopress_social_fb_img":"","_seopress_social_fb_img_attachment_id":0,"_seopress_social_fb_img_width":0,"_seopress_social_fb_img_height":0,"_seopress_social_twitter_title":"","_seopress_social_twitter_desc":"","_seopress_social_twitter_img":"","_seopress_social_twitter_img_attachment_id":0,"_seopress_social_twitter_img_width":0,"_seopress_social_twitter_img_height":0,"_seopress_redirections_value":"","_seopress_redirections_enabled":"","_seopress_redirections_enabled_regex":"","_seopress_redirections_logged_status":"both","_seopress_redirections_param":"","_seopress_redirections_type":301,"_seopress_analysis_target_kw":"","_seopress_news_disabled":"","_seopress_video_disabled":"","_seopress_video":[],"_seopress_pro_schemas_manual":[],"_seopress_pro_rich_snippets_disable_all":"","_seopress_pro_rich_snippets_disable":[],"_seopress_pro_schemas":[],"sig_custom_text":"","sig_image_type":"featured-image","sig_custom_image":0,"sig_is_disabled":false,"advgb_blocks_editor_width":"","advgb_blocks_columns_visual_guide":"","_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","footnotes":""},"doc_category":[8004],"doc_tag":[],"class_list":["post-9341","docs","type-docs","status-publish","hentry","doc_category-notifications"],"year_month":"2026-07","word_count":980,"total_views":"4296","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"Steve Burge","author_nicename":"steve","author_url":"https:\/\/publishpress.com\/author\/steve\/"},"doc_category_info":[{"term_name":"Notifications","term_url":"https:\/\/publishpress.com\/docs-category\/notifications\/"}],"doc_tag_info":[],"featured_img":false,"coauthors":[{"link":"https:\/\/publishpress.com\/author\/steve\/","display_name":"Steve Burge"}],"author_meta":{"author_link":"https:\/\/publishpress.com\/author\/steve\/","display_name":"Steve Burge"},"relative_dates":{"created":"Posted 9 years ago","modified":"Updated 1 year ago"},"absolute_dates":{"created":"Posted on December 14, 2017","modified":"Updated on July 4, 2025"},"absolute_dates_time":{"created":"Posted on December 14, 2017 7:47 pm","modified":"Updated on July 4, 2025 12:48 pm"},"featured_img_caption":"","tax_additional":{"doc_category":{"linked":["<a href=\"https:\/\/publishpress.com\/docs-category\/notifications\/\" class=\"advgb-post-tax-term\">Notifications<\/a>"],"unlinked":["<span class=\"advgb-post-tax-term\">Notifications<\/span>"],"slug":"doc_category","name":"Docs Categories"},"doc_tag":{"linked":[],"unlinked":[],"slug":"doc_tag","name":"Docs Tags"}},"series_order":"","knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/publishpress.com\/wp-json\/wp\/v2\/docs\/9341","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/publishpress.com\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/publishpress.com\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/publishpress.com\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/publishpress.com\/wp-json\/wp\/v2\/comments?post=9341"}],"version-history":[{"count":5,"href":"https:\/\/publishpress.com\/wp-json\/wp\/v2\/docs\/9341\/revisions"}],"predecessor-version":[{"id":368105,"href":"https:\/\/publishpress.com\/wp-json\/wp\/v2\/docs\/9341\/revisions\/368105"}],"wp:attachment":[{"href":"https:\/\/publishpress.com\/wp-json\/wp\/v2\/media?parent=9341"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/publishpress.com\/wp-json\/wp\/v2\/doc_category?post=9341"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/publishpress.com\/wp-json\/wp\/v2\/doc_tag?post=9341"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}