{"id":44498,"date":"2024-07-22T17:38:43","date_gmt":"2024-07-22T16:38:43","guid":{"rendered":"https:\/\/churchtools.academy\/help\/non-knowledgebase\/uncategorized\/how-do-i-use-placeholders-in-form-letters\/"},"modified":"2026-03-17T10:17:22","modified_gmt":"2026-03-17T09:17:22","password":"","slug":"how-do-i-use-placeholders-in-form-letters","status":"publish","type":"docs","link":"https:\/\/churchtools.academy\/en\/help\/administration\/place-holders\/how-do-i-use-placeholders-in-form-letters\/","title":{"rendered":"How to use placeholders in form letters?"},"content":{"rendered":"\n<p>If you want to contact several people, you can not only do this by e-mail or chat, but you also have the option of sending serial letters, e.g. thank you letters to all donors in your congregation.<\/p>\n\n\n\n<p>You can use placeholders in the form letters to personalize the texts of your letters quickly and easily.<br>You can use the placeholders both in the (HTML) templates of the form letters and in the text of the form letter itself.<\/p>\n\n\n\n<p>You can find out which placeholders you can currently use in form letters <a href=\"https:\/\/churchtools.academy\/en\/help\/administration\/place-holders\/placeholders-in-churchtools\/\" data-type=\"docs\" data-id=\"7645\">here<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Use placeholders in templates<\/h2>\n\n\n\n<p>You simply enter the placeholders in the (HTML) templates of your form letters. For example, if you want to enter the postal address of your addressees in a template, you would use the following placeholders: <\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>{{person.firstName}} {{person.lastName}}<\/li>\n\n\n\n<li>{{person.street}}<\/li>\n\n\n\n<li>{{person.zip}} {{person.city}}<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Use placeholders in the letter text<\/h2>\n\n\n\n<p>When creating a form letter, you can either enter the desired placeholders yourself in the text field or you can use the selection fields for the placeholders that we have built directly into the user interface.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Create-bulk-letter_Placeholders.png\"><img fetchpriority=\"high\" decoding=\"async\" width=\"1024\" height=\"764\" src=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Create-bulk-letter_Placeholders-1024x764.png\" alt=\"Create bulk letter - Placeholders\" class=\"wp-image-44503\" srcset=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Create-bulk-letter_Placeholders-1024x764.png 1024w, https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Create-bulk-letter_Placeholders-300x224.png 300w, https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Create-bulk-letter_Placeholders-768x573.png 768w, https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Create-bulk-letter_Placeholders-360x269.png 360w, https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Create-bulk-letter_Placeholders.png 1310w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/a><\/figure>\n\n\n\n<p>All available placeholders are displayed here and you can select them with one click.<br>There are placeholders for all personal data fields (including those that you have created yourself), for group information fields and for relationship fields.  <\/p>\n\n\n\n<aside class=\"wp-block-group ct-box ct-box-blue has-background is-vertical is-layout-flex wp-container-core-group-is-layout-002f1c27 wp-block-group-is-layout-flex\" style=\"border-radius:8px;border-left-color:#3e70ce;border-left-width:0.5rem;background-color:#f3f5f7;margin-top:var(--wp--preset--spacing--60);margin-bottom:var(--wp--preset--spacing--60)\">\n<p style=\"margin-top:0.5rem;margin-right:0.5rem;margin-bottom:0rem;margin-left:0.5rem\"><strong>Note<\/strong><\/p>\n\n\n\n<p style=\"margin-top:0rem;margin-right:0.5rem;margin-bottom:0.5rem;margin-left:0.5rem\">If a person has several children, the placeholders for the individual children are sorted according to the age of the children, with <em>first<\/em> standing for the oldest child and so on.<\/p>\n<\/aside>\n\n\n\n<p>Placeholders are highlighted in blue in the text (1) and a control overview (3) is displayed at the bottom of the text field, which informs you whether the information required for the placeholders is stored for all recipients.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Green: All information is available.<\/li>\n\n\n\n<li>Yellow: The information is missing for at least one of the recipients or you do not have permission to see the corresponding information.<\/li>\n<\/ul>\n\n\n\n<p>You can display the syntax of the placeholder (2) by moving the mouse over the placeholder.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Contact_Bulk-letter_Placeholder.png\"><img decoding=\"async\" width=\"1024\" height=\"633\" src=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Contact_Bulk-letter_Placeholder-1024x633.png\" alt=\"Contact - Bulk letter - Placeholder\" class=\"wp-image-44506\" srcset=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Contact_Bulk-letter_Placeholder-1024x633.png 1024w, https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Contact_Bulk-letter_Placeholder-300x185.png 300w, https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Contact_Bulk-letter_Placeholder-768x474.png 768w, https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Contact_Bulk-letter_Placeholder-360x222.png 360w, https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Contact_Bulk-letter_Placeholder.png 1240w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/a><\/figure>\n\n\n\n<aside class=\"wp-block-group ct-box ct-box-blue has-background is-vertical is-layout-flex wp-container-core-group-is-layout-002f1c27 wp-block-group-is-layout-flex\" style=\"border-radius:8px;border-left-color:#22c55e;border-left-width:0.5rem;background-color:#dcfce7;margin-top:var(--wp--preset--spacing--60);margin-bottom:var(--wp--preset--spacing--60)\">\n<p style=\"margin-top:0.5rem;margin-right:0.5rem;margin-bottom:0rem;margin-left:0.5rem\"><strong>Tip<\/strong><\/p>\n\n\n\n<p style=\"margin-top:0rem;margin-right:0.5rem;margin-bottom:0.5rem;margin-left:0.5rem\">If information is missing for individual recipients, you can directly display the user card of the person concerned in a new tab to add the missing information.<br><br>To do this, move the mouse over the yellow checkbox to display all persons for whom the information is missing (recognizable by the <em>crossed-out pen<\/em>; if you see a <em>crossed-out eye<\/em> here, it means that you do not have permission to see the information). Click on the blue icon to add the information directly: <\/p>\n<\/aside>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><a href=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Contact_Bulk-letter_enter-missing-parameters.png\"><img decoding=\"async\" width=\"421\" height=\"185\" src=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Contact_Bulk-letter_enter-missing-parameters.png\" alt=\"Contact - Bulk letter - enter missing parameters\" class=\"wp-image-44509\" style=\"width:299px;height:auto\" srcset=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Contact_Bulk-letter_enter-missing-parameters.png 421w, https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Contact_Bulk-letter_enter-missing-parameters-300x132.png 300w, https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/07\/Contact_Bulk-letter_enter-missing-parameters-360x158.png 360w\" sizes=\"(max-width: 421px) 100vw, 421px\" \/><\/a><\/figure>\n\n\n\n<aside class=\"wp-block-group ct-artikel-zum-weiterlesen has-background is-layout-constrained wp-container-core-group-is-layout-89fd719a wp-block-group-is-layout-constrained\" style=\"border-radius:8px;background-color:#f9fafb;margin-top:24px;margin-bottom:24px;padding-top:32px;padding-right:24px;padding-bottom:32px;padding-left:24px\">\n<h2 class=\"wp-block-heading has-medium-font-size\">Read more<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/churchtools.academy\/en\/help\/administration\/place-holders\/17-placeholders\/\" data-type=\"docs\" data-id=\"7644\">Placeholder overview<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/churchtools.academy\/en\/help\/administration\/place-holders\/17-how-to-use-control-structures-with-placeholders\/\" data-type=\"docs\" data-id=\"7663\">How do I use control structures with placeholders?<\/a><\/li>\n<\/ul>\n<\/aside>\n","protected":false},"excerpt":{"rendered":"<p>If you want to contact several people, you can not only do this by e-mail or chat, but you also have the option of sending serial letters, e.g. thank you letters to all donors in your congregation. You can use placeholders in the form letters to personalize the texts of your letters quickly and easily.You [&hellip;]<\/p>\n","protected":false},"author":6,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_category":[483],"doc_tag":[],"knowledge_base":[426],"class_list":["post-44498","docs","type-docs","status-publish","hentry","doc_category-place-holders","knowledge_base-administration"],"pp_statuses_selecting_workflow":false,"pp_workflow_action":"current","pp_status_selection":"publish","acf":[],"year_month":"2026-05","word_count":312,"total_views":"512","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"Jasper Stehmeier","author_nicename":"jstehmeier","author_url":"https:\/\/churchtools.academy\/en\/author\/jstehmeier\/"},"doc_category_info":[{"term_name":"Place Holders","term_url":"https:\/\/churchtools.academy\/en\/help\/administration\/place-holders\/"}],"doc_tag_info":[],"knowledge_base_info":[{"term_name":"Administration","term_url":"https:\/\/churchtools.academy\/en\/help\/administration\/","term_slug":"administration"}],"knowledge_base_slug":["administration"],"_links":{"self":[{"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/44498","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/comments?post=44498"}],"version-history":[{"count":10,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/44498\/revisions"}],"predecessor-version":[{"id":50111,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/44498\/revisions\/50111"}],"wp:attachment":[{"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/media?parent=44498"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/doc_category?post=44498"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/doc_tag?post=44498"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/knowledge_base?post=44498"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}