{"id":25,"date":"2018-09-19T13:42:37","date_gmt":"2018-09-19T05:42:37","guid":{"rendered":"https:\/\/www.intelliwolf.com\/?p=25"},"modified":"2019-05-31T08:47:52","modified_gmt":"2019-05-31T00:47:52","slug":"how-to-edit-the-new-user-email-template-in-wordpress","status":"publish","type":"post","link":"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/","title":{"rendered":"How To Edit The New User Email Template In WordPress"},"content":{"rendered":"\n<p>I was working on building out a theme for a WordPress site that is essentially a marketplace for services. We had two types of people signing up: hirers and job seekers. The default initial email was fine for hirers, but we found a lot of the job seekers  were signing up and not completing their profile, which meant they'd never show up in the on-site search and never be hired.<\/p>\n\n\n\n<p>All we needed was to tack on an extra paragraph to the first email for a certain type of user.<\/p>\n\n\n\n<p>None of the plugins could handle the detail we needed. All the guides were for replacing the email message with a custom message. The problem with that is it's a lot more coding to get that individual password generation url that WordPress does by default.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">The Solution<\/h2>\n\n\n\n<p>So how did we edit the new user email template in WordPress?<\/p>\n\n\n\n<ul><li>Add a filter to hook into&nbsp;<em>wp_new_user_notification_email<\/em>&nbsp;which takes 3 arguments<\/li><li>Pass&nbsp;<em>$wp_new_user_notification_email, $user, $blogname&nbsp;<\/em>into the filter<\/li><li>Conditionally add&nbsp;<em>$wp_new_user_notification_email['message'] .= sprintf(\"\\r\\nMessage Addition\");<\/em><\/li><li>Return&nbsp;<em>$wp_new_user_notification_email<\/em><\/li><\/ul>\n\n\n\n<p>Let's see how that actually worked in the code...<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>\/* Customize Emails *\/\nadd_filter('wp_new_user_notification_email', 'rego_welcome_email', 10, 3);\n\nfunction rego_welcome_email($wp_new_user_notification_email, $user, $blogname)\n{\n  if (get_user_meta($user->ID, 'membership_user_role', true) == 'job_seeker')\n  {\n    # change the default email\n    $wp_new_user_notification_email['message'] .= sprintf(\"\\r\\nWhile you're there,\n      please complete your profile, so that potential hirers can find you and\n      contact you.\\r\\n\\r\\nSee you there,\\r\\nWebsite Owner\");\n  }\n  return $wp_new_user_notification_email;\n}<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Unpacking The Code<\/h2>\n\n\n\n<pre class=\"wp-block-code\"><code>add_filter('wp_new_user_notification_email', 'rego_welcome_email', 10, 3);<\/code><\/pre>\n\n\n\n<p>This is a filter, rather than a hook. It means we're overlaying our own information, while preserving anything we don't overwrite.<\/p>\n\n\n\n<p>Notice the \"10, 3\" at the end? The 10 is the priority of the filter and 3 is how many arguments are passing through to the function. Leave them as written. Just remember that you have to have 3 arguments in the function.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>function rego_welcome_email($wp_new_user_notification_email, $user, $blogname) {}<\/code><\/pre>\n\n\n\n<p>Even though we're not using <em>$blogname<\/em>, we still need to pass it in, because the filter told the function to expect 3 arguments. Your code will throw an error if you don't have 3 arguments here.<\/p>\n\n\n\n<p>With PHP, the names of the arguments here don't matter (except for code readability). The information will be passed to your function in that order, no matter what you call it. It's best to stick with standard naming conventions where possible.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>if (get_user_meta($user->ID, 'membership_user_role', true) == 'job_seeker') {}<\/code><\/pre>\n\n\n\n<p>At another place, earlier in the process, our code assigns \"job_seeker\" as a user_meta for job seekers. This allowed us to only send this email addition to job seekers, rather than to everyone. If you wanted to send the addition to everyone, you'd just leave out this conditional.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>$wp_new_user_notification_email['message'] .= sprintf(\"\\r\\nMessage Addition\");<\/code><\/pre>\n\n\n\n<p><em>$wp_new_user_notification_email<\/em> is passed as an associative array. The <em>['message']<\/em> means this will only affect the body of the email. See below for the code to change the Subject.<\/p>\n\n\n\n<p>The \".=\" means we're adding to the end of the email message. If you wanted to&nbsp;<strong>replace<\/strong> the body of the message, you'd just do \"=\" without the full stop.<\/p>\n\n\n\n<p>If you wanted to add your message to the start of the email, you'd do something like this:<\/p>\n\n\n\n<p>Note the \"\\r\\n\". That adds a new line within the sprintf format. This just makes the email easier to read. Run some tests and see what works best for your content.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>$old_message = $wp_new_user_notification_email['message'];\n$wp_new_user_notification_email['message'] = sprintf(\"Message Addition\\r\\n\");\n$wp_new_user_notification_email['message'] .= $old_message;<\/code><\/pre>\n\n\n\n<p>By doing that, you pass the original message to a variable, start the email body fresh with your message, then add the original message back in.<\/p>\n\n\n\n<p>You could add a further part of the message (like a custom sign-off) at the end using the code we originally used.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>return $wp_new_user_notification_email;<\/code><\/pre>\n\n\n\n<p>This is very important. It tells the filter to go and do the changes you made. If you don't return this, none of the rest matters. You don't need to return the other arguments that you passed to this function.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What Else Can You Change In The New Email?<\/h2>\n\n\n\n<p>Logging the output of&nbsp;<em>$wp_new_user_notification_email<\/em> you'll find it has 4 elements:<\/p>\n\n\n\n<ul><li>[to] - the address of the new user<\/li><li>[subject] - default is \"[%s] Your username and password info\"<\/li><li>[message] - contains the username and a link to reset their password<\/li><li>[headers] - default is blank. You could use this to set, say a HTML email<\/li><\/ul>\n\n\n\n<p>You don't want to touch the [to] and you really should mess with [headers] unless you know what you're doing and test extensively. The only element other than [message] left is the [subject].<\/p>\n\n\n\n<p>The way you change the subject on WordPress's default new user email is with this code:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>$wp_new_user_notification_email['subject'] = sprintf(\"New Subject\");<\/code><\/pre>\n\n\n\n<p>You may have noticed in the default that is uses \"[%s]\". That will add the website name to the subject line. For example, such an email from this site would be \"[Intelliwolf]\".<\/p>\n\n\n\n<p>If you wanted to use your site name in that same way, the code you'd use might look like:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>$wp_new_user_notification_email['subject'] = sprintf(\"Your Login at %s\", $blogname);<\/code><\/pre>\n\n\n\n<p>This will put&nbsp;<em>$blogname<\/em> wherever you have put %s.<\/p>\n\n\n\n<p>You could use this same technique in the message body.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"send-as-html\">How to send the wp_mail() as HTML<\/h3>\n\n\n\n<p>I don't recommend sending the welcome email with HTML formatting because you don't want to do anything to impact deliverability for a password reset email.<\/p>\n\n\n\n<p>If you really did want to send the email formatted as HTML, rather than plaintext, you would add the following line above the <em>return<\/em>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>$wp_new_user_notification_email['headers'] = array('Content-Type: text\/html; charset=UTF-8');<\/code><\/pre>\n\n\n\n<p>Then you would add your HTML formatted message to the <em>['message']<\/em> section.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Further Personalise the Email Message<\/h2>\n\n\n\n<p>If you really want to personalise the email message, remember that you have access to&nbsp;<em>$user<\/em>, which is the WP_User object.<\/p>\n\n\n\n<p>Some of the key fields you might be interested in for personalising these emails are:<\/p>\n\n\n\n<ul><li><em>$user-&gt;data-&gt;user_email<\/em> - their email address<\/li><li><em>$user-&gt;data-&gt;user_registered<\/em> - the date &amp; time of registration<\/li><li><em>$user-&gt;data-&gt;user_login<\/em> - the Username they entered<\/li><li><em>$user-&gt;ID<\/em> - their WordPress user ID<\/li><\/ul>\n\n\n\n<p>If you found this guide helpful, we'd love to hear from you in the comments section below.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>I was working on building out a theme for a WordPress site that is essentially a marketplace for services. We had two types of people signing up: hirers and job seekers. The default initial email was fine for hirers, but we found a lot of the job seekers were signing up and not completing their<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4],"tags":[],"yoast_head":"\n<title>How To Edit The New User Email Template In Wordpress<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How To Edit The New User Email Template In Wordpress\" \/>\n<meta property=\"og:description\" content=\"I was working on building out a theme for a WordPress site that is essentially a marketplace for services. We had two types of people signing up: hirers and job seekers. The default initial email was fine for hirers, but we found a lot of the job seekers were signing up and not completing their\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/\" \/>\n<meta property=\"og:site_name\" content=\"Intelliwolf\" \/>\n<meta property=\"article:published_time\" content=\"2018-09-19T05:42:37+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2019-05-31T00:47:52+00:00\" \/>\n<meta name=\"author\" content=\"Mike Haydon\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Mike Haydon\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"6 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/\"},\"author\":{\"name\":\"Mike Haydon\",\"@id\":\"https:\/\/www.intelliwolf.com\/#\/schema\/person\/7209e3ff14822e4d70d5f194a310f343\"},\"headline\":\"How To Edit The New User Email Template In WordPress\",\"datePublished\":\"2018-09-19T05:42:37+00:00\",\"dateModified\":\"2019-05-31T00:47:52+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/\"},\"wordCount\":963,\"commentCount\":2,\"publisher\":{\"@id\":\"https:\/\/www.intelliwolf.com\/#organization\"},\"articleSection\":[\"Admin Customization\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/\",\"url\":\"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/\",\"name\":\"How To Edit The New User Email Template In Wordpress\",\"isPartOf\":{\"@id\":\"https:\/\/www.intelliwolf.com\/#website\"},\"datePublished\":\"2018-09-19T05:42:37+00:00\",\"dateModified\":\"2019-05-31T00:47:52+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.intelliwolf.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Admin Customization\",\"item\":\"https:\/\/www.intelliwolf.com\/category\/admin-customization\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"How To Edit The New User Email Template In WordPress\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.intelliwolf.com\/#website\",\"url\":\"https:\/\/www.intelliwolf.com\/\",\"name\":\"Intelliwolf\",\"description\":\"WordPress, Web Design &amp; Coding Tutorials\",\"publisher\":{\"@id\":\"https:\/\/www.intelliwolf.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.intelliwolf.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.intelliwolf.com\/#organization\",\"name\":\"Intelliwolf\",\"url\":\"https:\/\/www.intelliwolf.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.intelliwolf.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.intelliwolf.com\/wp-content\/uploads\/intelliwolf-logo-300t.png\",\"contentUrl\":\"https:\/\/www.intelliwolf.com\/wp-content\/uploads\/intelliwolf-logo-300t.png\",\"width\":300,\"height\":100,\"caption\":\"Intelliwolf\"},\"image\":{\"@id\":\"https:\/\/www.intelliwolf.com\/#\/schema\/logo\/image\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.intelliwolf.com\/#\/schema\/person\/7209e3ff14822e4d70d5f194a310f343\",\"name\":\"Mike Haydon\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.intelliwolf.com\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/d5f4754fae310a04dede91d15e57c8a0?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/d5f4754fae310a04dede91d15e57c8a0?s=96&d=mm&r=g\",\"caption\":\"Mike Haydon\"},\"sameAs\":[\"https:\/\/intelliwolf.com\/about-mike-haydon\/\"]}]}<\/script>\n","yoast_head_json":{"title":"How To Edit The New User Email Template In Wordpress","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/","og_locale":"en_US","og_type":"article","og_title":"How To Edit The New User Email Template In Wordpress","og_description":"I was working on building out a theme for a WordPress site that is essentially a marketplace for services. We had two types of people signing up: hirers and job seekers. The default initial email was fine for hirers, but we found a lot of the job seekers were signing up and not completing their","og_url":"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/","og_site_name":"Intelliwolf","article_published_time":"2018-09-19T05:42:37+00:00","article_modified_time":"2019-05-31T00:47:52+00:00","author":"Mike Haydon","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Mike Haydon","Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/#article","isPartOf":{"@id":"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/"},"author":{"name":"Mike Haydon","@id":"https:\/\/www.intelliwolf.com\/#\/schema\/person\/7209e3ff14822e4d70d5f194a310f343"},"headline":"How To Edit The New User Email Template In WordPress","datePublished":"2018-09-19T05:42:37+00:00","dateModified":"2019-05-31T00:47:52+00:00","mainEntityOfPage":{"@id":"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/"},"wordCount":963,"commentCount":2,"publisher":{"@id":"https:\/\/www.intelliwolf.com\/#organization"},"articleSection":["Admin Customization"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/","url":"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/","name":"How To Edit The New User Email Template In Wordpress","isPartOf":{"@id":"https:\/\/www.intelliwolf.com\/#website"},"datePublished":"2018-09-19T05:42:37+00:00","dateModified":"2019-05-31T00:47:52+00:00","breadcrumb":{"@id":"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.intelliwolf.com\/how-to-edit-the-new-user-email-template-in-wordpress\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.intelliwolf.com\/"},{"@type":"ListItem","position":2,"name":"Admin Customization","item":"https:\/\/www.intelliwolf.com\/category\/admin-customization\/"},{"@type":"ListItem","position":3,"name":"How To Edit The New User Email Template In WordPress"}]},{"@type":"WebSite","@id":"https:\/\/www.intelliwolf.com\/#website","url":"https:\/\/www.intelliwolf.com\/","name":"Intelliwolf","description":"WordPress, Web Design &amp; Coding Tutorials","publisher":{"@id":"https:\/\/www.intelliwolf.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.intelliwolf.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.intelliwolf.com\/#organization","name":"Intelliwolf","url":"https:\/\/www.intelliwolf.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.intelliwolf.com\/#\/schema\/logo\/image\/","url":"https:\/\/www.intelliwolf.com\/wp-content\/uploads\/intelliwolf-logo-300t.png","contentUrl":"https:\/\/www.intelliwolf.com\/wp-content\/uploads\/intelliwolf-logo-300t.png","width":300,"height":100,"caption":"Intelliwolf"},"image":{"@id":"https:\/\/www.intelliwolf.com\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/www.intelliwolf.com\/#\/schema\/person\/7209e3ff14822e4d70d5f194a310f343","name":"Mike Haydon","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.intelliwolf.com\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/d5f4754fae310a04dede91d15e57c8a0?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/d5f4754fae310a04dede91d15e57c8a0?s=96&d=mm&r=g","caption":"Mike Haydon"},"sameAs":["https:\/\/intelliwolf.com\/about-mike-haydon\/"]}]}},"_links":{"self":[{"href":"https:\/\/www.intelliwolf.com\/wp-json\/wp\/v2\/posts\/25"}],"collection":[{"href":"https:\/\/www.intelliwolf.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.intelliwolf.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.intelliwolf.com\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.intelliwolf.com\/wp-json\/wp\/v2\/comments?post=25"}],"version-history":[{"count":0,"href":"https:\/\/www.intelliwolf.com\/wp-json\/wp\/v2\/posts\/25\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.intelliwolf.com\/wp-json\/wp\/v2\/media?parent=25"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.intelliwolf.com\/wp-json\/wp\/v2\/categories?post=25"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.intelliwolf.com\/wp-json\/wp\/v2\/tags?post=25"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}