{"id":42790,"date":"2025-11-17T14:05:33","date_gmt":"2025-11-17T13:05:33","guid":{"rendered":"https:\/\/churchtools.academy\/help\/non-knowledgebase\/uncategorized\/how-can-i-customize-translations-in-churchtools\/"},"modified":"2025-12-04T08:48:47","modified_gmt":"2025-12-04T07:48:47","password":"","slug":"how-to-customize-translations-in-churchtools","status":"publish","type":"docs","link":"https:\/\/churchtools.academy\/en\/help\/administration\/languages\/how-to-customize-translations-in-churchtools\/","title":{"rendered":"How to customize translations in ChurchTools?"},"content":{"rendered":"\n<p>In ChurchTools, translations are used to convert technical terms into understandable language. We call these technical terms keys and they are used by ChurchTools in the background. <\/p>\n\n\n\n<p>Keys open up some great opportunities for you:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Introduce your own designations: <\/strong>You can customize the translations for keys. This is useful if you use different terms in your church than those used by ChurchTools by default. <\/li>\n\n\n\n<li><strong>Create new languages: <\/strong>You even have the option of translating ChurchTools into a language that we do not provide.<\/li>\n\n\n\n<li><strong>Create new keys: <\/strong>You can also create new keys in ChurchTools. For example, you can display names for your church rooms in several languages or personalize <a href=\"https:\/\/churchtools.academy\/de\/help\/system-settings\/datenschutz\/wie-bearbeite-ich-die-einwilligungserklarung\/\">declarations of consent<\/a>. <\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">How to update translations?<\/h2>\n\n\n\n<p>We always provide you with the latest translations available to us. They are incorporated into your ChurchTools with every release. <\/p>\n\n\n\n<p>If you would like to have the latest changes that we offer for the translations, you can manually initiate the update between your Church Tools and our systems via <em>Update translations<\/em> (1). Your Church Tools will then retrieve the latest version and add it to your system. <\/p>\n\n\n\n<p>If you maintain a language yourself, you will of course have to make the entries manually. You can find more information on this below. <\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><a href=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Keys.png\"><img fetchpriority=\"high\" decoding=\"async\" width=\"2258\" height=\"1030\" src=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Keys.png\" alt=\"Translations - Keys\" class=\"wp-image-42810\" srcset=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Keys.png 2258w, https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Keys-300x137.png 300w, https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Keys-1024x467.png 1024w, https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Keys-768x350.png 768w, https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Keys-1536x701.png 1536w, https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Keys-2048x934.png 2048w, https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Keys-360x164.png 360w\" sizes=\"(max-width: 2258px) 100vw, 2258px\" \/><\/a><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Incomplete-translations.png\"><img decoding=\"async\" width=\"1024\" height=\"212\" src=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Incomplete-translations-1024x212.png\" alt=\"Translations - Incomplete translations\" class=\"wp-image-42813\" srcset=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Incomplete-translations-1024x212.png 1024w, https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Incomplete-translations-300x62.png 300w, https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Incomplete-translations-768x159.png 768w, https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Incomplete-translations-1536x318.png 1536w, https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Incomplete-translations-2048x423.png 2048w, https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Incomplete-translations-360x74.png 360w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/a><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">What options do the filters offer me?<\/h2>\n\n\n\n<p>You have three options for filtering the available keys.<\/p>\n\n\n\n<p>With the filter <em><strong>module name<\/strong><\/em> (2), you can only display the keys that are used in a specific ChurchTools module.<\/p>\n\n\n\n<p>With <em><strong>Incomplete translations<\/strong><\/em> (3) you can filter the keys by language and the respective status of the translations, for example to find missing or outdated ones. After selecting the <em>language<\/em>, the following filters are also available: <em>All<\/em>, <em>Missing<\/em>, <em>Outdated<\/em>, <em>Check<\/em>. <\/p>\n\n\n\n<p>With the classic <em><strong>search field<\/strong><\/em> (4) you can search for keywords in all currently displayed entries.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How to adapt the translations of existing keys?<\/h2>\n\n\n\n<p>To customize a translation for a key, click once on the desired <em>key<\/em> (5). The list of existing translations opens. You can enter a new <em>translation<\/em> (7) for the key using the <em>pencil symbol<\/em> (6) at the end of the line.  <\/p>\n\n\n\n<p>For example, if you call your small groups in your church &#8220;small groups&#8221;, you can search for the term &#8221; <em>small group&#8221; <\/em>in the search field and replace the word with &#8220;small groups&#8221; in the keys found.<\/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\">Please bear in mind that <strong>the changes you have made will not be overwritten when the respective language is updated by a ChurchTools release in the future.<\/strong> This has the advantage that your entries will not be lost.<br><strong>However, it also means that you will not receive any new content <strong>from ChurchTools <\/strong>for the translations you have changed. <\/strong>For example, if we change something about the use of the key in ChurchTools and therefore adapt the translations, this change will <strong>not<\/strong> be transferred to your ChurchTools.  <\/p>\n<\/aside>\n\n\n\n<h2 class=\"wp-block-heading\">What do the colored symbols mean?<\/h2>\n\n\n\n<p>Occasionally, <em>colored symbols<\/em> (8) are displayed during a translation.<\/p>\n\n\n\n<p><em>Yellow warning triangles<\/em> indicate outdated translations. In these cases, the German text has been adapted, but the respective language has not yet been adapted. <\/p>\n\n\n\n<p>The <em>green tick symbol<\/em> can be used to accept a translation that is highlighted in yellow. This should only be done if the translated text still matches the German translation. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How to create and use new keys?<\/h2>\n\n\n\n<p>You can create new keys for everything that is managed in the <a href=\"https:\/\/churchtools.academy\/en\/help\/churchtools-modules\/master-data-finance\/master-data-overview\/\" data-type=\"link\" data-id=\"https:\/\/churchtools.academy\/de\/help\/churchtools-module\/stammdaten\/30-uberblick-der-stammdaten\/\">master data<\/a>. To create a new key, click on the <em>Create new translation<\/em> button (9) at the top left.<br>A configuration window opens. As an example, we will create a key for a room here:  <\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Under <em>Key<\/em>, enter a name for the new key. You are free to choose your own name. However, we strongly recommend that you use names that can be found quickly and easily using the search field. For example, put the abbreviation of your church first, as shown in the image. This will ensure that you can find and edit the keys you have created yourself at any time.<br>In the example, the room is named &#8220;Room1&#8221;.    <br><\/li>\n\n\n\n<li>Under <em>Module name<\/em>, you must select the module in which the new key is to be used. Each key must be assigned to a module and can only be used there. <br>Example: As the room is a resource, we assign it to the <em>churchresource<\/em> module. <br>The technical terms used here are explained in our reference <a href=\"https:\/\/churchtools.academy\/de\/?p=42783&amp;post_type=docs&amp;preview_id=42783\">Technical terms for ChurchTools modules<\/a>. <br><\/li>\n\n\n\n<li>Add translations for all <em>languages<\/em> relevant to you. Depending on the system language set, the respective translation for your key will then be displayed.   <br>&#8220;Room1&#8221; from our example is the &#8220;kitchen&#8221;, so we enter the respective term for all relevant languages.<br><\/li>\n\n\n\n<li>Click <em>Save<\/em> to save your entries.<\/li>\n<\/ol>\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\">Your key may not be translated correctly immediately. This is because your browser keeps the translations in its cache for some time. Empty your browser&#8217;s cache if your key is not translated correctly.  <\/p>\n<\/aside>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><a href=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Create-new-translation.png\"><img decoding=\"async\" width=\"802\" height=\"696\" src=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Create-new-translation.png\" alt=\"Translations - Create new translation\" class=\"wp-image-42819\" style=\"width:546px;height:auto\" srcset=\"https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Create-new-translation.png 802w, https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Create-new-translation-300x260.png 300w, https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Create-new-translation-768x666.png 768w, https:\/\/churchtools.academy\/wp-content\/uploads\/2025\/11\/Translations_Create-new-translation-360x312.png 360w\" sizes=\"(max-width: 802px) 100vw, 802px\" \/><\/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\">Article to read more<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><mark class=\"has-inline-color has-vivid-red-color\"><a href=\"https:\/\/churchtools.academy\/en\/help\/administration\/languages\/internationalization\/\">Overview of languages and translations<\/a><\/mark><\/li>\n\n\n\n<li><mark class=\"has-inline-color has-vivid-red-color\"><a href=\"https:\/\/churchtools.academy\/de\/help\/mein-churchtools\/personalisierung\/wie-aendere-ich-die-sprache-meines-churchtools\/\">How do I change the language of my ChurchTool?<\/a><\/mark><\/li>\n\n\n\n<li><mark class=\"has-inline-color has-vivid-red-color\"><a href=\"https:\/\/churchtools.academy\/de\/?p=42784&amp;post_type=docs&amp;preview_id=42784\">How do I add new languages to ChurchTools?<\/a><\/mark><\/li>\n\n\n\n<li><a href=\"https:\/\/churchtools.academy\/de\/?p=42783&amp;post_type=docs&amp;preview_id=42783\" data-type=\"docs\" data-id=\"42279\">Technical names of the ChurchTools modules<\/a><\/li>\n<\/ul>\n<\/aside>\n","protected":false},"excerpt":{"rendered":"<p>In ChurchTools, translations are used to convert technical terms into understandable language. We call these technical terms keys and they are used by ChurchTools in the background. Keys open up some great opportunities for you: How to update translations? We always provide you with the latest translations available to us. They are incorporated into your [&hellip;]<\/p>\n","protected":false},"author":43,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_category":[696],"doc_tag":[],"knowledge_base":[426],"class_list":["post-42790","docs","type-docs","status-publish","hentry","doc_category-languages","knowledge_base-administration"],"pp_statuses_selecting_workflow":false,"pp_workflow_action":"current","pp_status_selection":"publish","acf":[],"year_month":"2026-04","word_count":713,"total_views":"714","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"Stefan Krumsdorf","author_nicename":"skrumsdorf","author_url":"https:\/\/churchtools.academy\/en\/author\/skrumsdorf\/"},"doc_category_info":[{"term_name":"Languages","term_url":"https:\/\/churchtools.academy\/en\/help\/administration\/languages\/"}],"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\/42790","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\/43"}],"replies":[{"embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/comments?post=42790"}],"version-history":[{"count":13,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/42790\/revisions"}],"predecessor-version":[{"id":42824,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/42790\/revisions\/42824"}],"wp:attachment":[{"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/media?parent=42790"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/doc_category?post=42790"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/doc_tag?post=42790"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/churchtools.academy\/en\/wp-json\/wp\/v2\/knowledge_base?post=42790"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}