{"id":9374,"date":"2024-03-25T16:49:37","date_gmt":"2024-03-25T14:49:37","guid":{"rendered":"https:\/\/churchtools.academy\/?post_type=docs&#038;p=9374"},"modified":"2025-10-07T07:49:29","modified_gmt":"2025-10-07T06:49:29","password":"","slug":"17-placeholders","status":"publish","type":"docs","link":"https:\/\/churchtools.academy\/en\/help\/administration\/place-holders\/17-placeholders\/","title":{"rendered":"Overview Placeholders"},"content":{"rendered":"\n<p>With placeholders, you can quickly and easily create personalised texts for different recipients or use cases without having to write each text individually. Instead, you can write a general text and use placeholders in it to customise the text for you.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Where can I use placeholders?<\/h2>\n\n\n\n<p>From version v3.103.0, ChurchTools uses new placeholders that open up many new possibilities for you.<br>You can currently use the placeholders wherever you can write emails or send form letters from within ChurchTools. The use in label printing will follow. &nbsp;<\/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>Existing placeholders<\/strong><\/p>\n\n\n\n<p style=\"margin-top:0rem;margin-right:0.5rem;margin-bottom:0.5rem;margin-left:0.5rem\">The placeholders that you have been able to use in ChurchTools up to now can still be used. This ensures that the texts you have already created that use placeholders will continue to work.<\/p>\n<\/aside>\n\n\n\n<p>Depending on the context in which you write a text, different placeholders are available to you, which you can use either via the new user interface or by manually entering the placeholder ( e.g: <code>{{person.firstName}}<\/code> (first name of the person)). &nbsp;<\/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:#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 you want to restrict the use of DB fields as placeholders, you can set this individually for each DB field in the master data of the People &amp; Groups module.<br><br><img fetchpriority=\"high\" decoding=\"async\" width=\"1180\" height=\"950\" class=\"wp-image-14128\" style=\"width: 400px\" src=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/03\/CleanShot-2024-03-21-at-12.22.24@2x.png\" alt=\"\" srcset=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/03\/CleanShot-2024-03-21-at-12.22.24@2x.png 1180w, https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/03\/CleanShot-2024-03-21-at-12.22.24@2x-300x242.png 300w, https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/03\/CleanShot-2024-03-21-at-12.22.24@2x-1024x824.png 1024w, https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/03\/CleanShot-2024-03-21-at-12.22.24@2x-768x618.png 768w, https:\/\/churchtools.academy\/wp-content\/uploads\/2024\/03\/CleanShot-2024-03-21-at-12.22.24@2x-360x290.png 360w\" sizes=\"(max-width: 1180px) 100vw, 1180px\" \/><\/p>\n<\/aside>\n\n\n\n<p><strong><a href=\"https:\/\/churchtools.academy\/en\/help\/administration\/place-holders\/17-how-to-use-placeholders-in-e-mails\/\" data-type=\"docs\" data-id=\"9372\">How to use placeholders in e-mails<\/a><\/strong><br>Whether you are manually writing an e-mail to people or groups or having e-mails sent automatically by ChurchTools, in most cases you can now use many new placeholders.<\/p>\n\n\n\n<p><strong>Placeholders in form letters<\/strong><br>Whether in the HTML template or in the text of your e-mail merge &#8211; you can now use the new placeholders here too.<\/p>\n\n\n\n<p><strong>Placeholders in donation receipts<\/strong><br>You use special placeholders from the \u201cFinance\u201d module in donation receipts.<\/p>\n\n\n\n<p><strong>Placeholder in label printing<\/strong><br>This function will be available in an upcoming version of ChurchTools.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Which placeholders are available?<\/h2>\n\n\n\n<p>We have also compiled a list of all <a href=\"https:\/\/churchtools.academy\/en\/help\/administration\/place-holders\/17-placeholders-in-churchtools\/\" data-type=\"docs\" data-id=\"9375\">available placeholders<\/a> so that you can quickly find the one you are looking for.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Further use cases<\/h2>\n\n\n\n<p>You can also use control structures with the placeholders, e.g. to include an automated, gender-specific salutation in your e-mails using if-then relationships. We explain how to implement this and other use cases in our <a href=\"https:\/\/churchtools.academy\/en\/help\/administration\/place-holders\/17-how-to-use-control-structures-with-placeholders\/\" data-type=\"docs\" data-id=\"9371\">tutorial<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>With placeholders, you can quickly and easily create personalised texts for different recipients or use cases without having to write each text individually. Instead, you can write a general text and use placeholders in it to customise the text for you. Where can I use placeholders? From version v3.103.0, ChurchTools uses new placeholders that open [&hellip;]<\/p>\n","protected":false},"author":7,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_category":[483],"doc_tag":[527],"knowledge_base":[426],"class_list":["post-9374","docs","type-docs","status-publish","hentry","doc_category-place-holders","doc_tag-link-missing","knowledge_base-administration"],"pp_statuses_selecting_workflow":false,"pp_workflow_action":"current","pp_status_selection":"publish","acf":[],"year_month":"2026-04","word_count":281,"total_views":"2208","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"Victoria Weidemann","author_nicename":"vweidemann","author_url":"https:\/\/churchtools.academy\/en\/author\/vweidemann\/"},"doc_category_info":[{"term_name":"Place Holders","term_url":"https:\/\/churchtools.academy\/en\/help\/administration\/place-holders\/"}],"doc_tag_info":[{"term_name":"link missing","term_url":"https:\/\/churchtools.academy\/en\/docs-tag\/link-missing\/"}],"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\/9374","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\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/comments?post=9374"}],"version-history":[{"count":5,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/9374\/revisions"}],"predecessor-version":[{"id":40938,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/9374\/revisions\/40938"}],"wp:attachment":[{"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/media?parent=9374"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/doc_category?post=9374"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/doc_tag?post=9374"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/knowledge_base?post=9374"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}