{"id":24550,"date":"2017-10-06T07:18:54","date_gmt":"2017-10-06T06:18:54","guid":{"rendered":"https:\/\/www.topdesk.com\/en\/?p=24550"},"modified":"2025-05-07T12:55:08","modified_gmt":"2025-05-07T11:55:08","slug":"insertion-fields-personalize-email-templates","status":"publish","type":"post","link":"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/","title":{"rendered":"Personalize your email templates with insertion fields"},"content":{"rendered":"<div class=\"section post-body\">\n<p>Have you always wondered what the <strong>[] insert field\/list<\/strong> is for? Or do you get intimidated by all the options in the pop up? In this post, we\u2019ll guide you through the jungle of insertion options.<\/p>\n<p>&nbsp;<\/p>\n<h3>What do insertion fields do?<\/h3>\n<p>Inserting a field is ideal for including card-specific information in emails. The insertion field works as a placeholder for the value of a card field. When an email action is executed from a card, TOPdesk looks up the value of the field on that particular card, and inserts it into the email. You can insert fields from the card type to which the e-mail template applies, or fields from cards that are linked to that card.<\/p>\n<h3>When to use insertion fields?<\/h3>\n<p>Insertion fields are most often used for personalizing an email: automatically insert the caller\u2019s email address in the address field, and start the body of the mail with the name of the caller.<\/p>\n<p>When your organization uses the mail import functionality, insertion fields even become an essential feature. When you insert the call number into the subject line, and a customer replies to the email, their reply will be automatically imported into the correct call.<\/p>\n<h3>Example: inserting a call number into the subject line<\/h3>\n<p>To insert the call number into the subject line, just click the icon with \u2018[ ]\u2019 next to the \u2018subject\u2019 line and select \u2018Call number\u2019 in the pop up menu.<\/p>\n<img decoding=\"async\" title=\"Insert call number.png\" src=\"https:\/\/blog2.topdesk.com\/hs-fs\/hubfs\/UG\/Insert%20call%20%20number.png?width=714&amp;name=Insert%20call%20%20number.png\" alt=\"Insert call number.png\" width=\"714\" data-constrained=\"true\" \/>\n<h4>How do I find the field I need?<\/h4>\n<p>As you can see in the image above, there are a lot of fields to choose from. So how do you know where to find what you want?<\/p>\n<ul>\n<li><strong>For fields on the card itself:<\/strong> check where the field is located on the card. The folder structure in the &#8216;Insert field&#8217; pop-up reflects the groups on the card.<\/li>\n<li><strong>For fields on a linked card:<\/strong> scroll past the folder icons to see all linked cards and their fields.<\/li>\n<\/ul>\n<p>If you get lost in the fields, check the text at the bottom next to \u2018selected field\u2019. It will show you the card you selected and then the field. Here in the example image you see \u2018Caller_(registered)\u2019, which is the linked card, and then \u2018Date_of_Birth\u2019, which is the field selected on the caller card.<\/p>\n<p><strong>Tip:\u00a0<\/strong>If you want to change the way a date field is shown in the email, select \u2018formatting options\u2019 next to \u2018selected field\u2019.<\/p>\n<h3>Check, so these are the insertion fields. And what do I need the lists for?<\/h3>\n<p>A list can only show fields of one card type, but you can display multiple fields in the list. This way you can send an email that, for example, contains a list with the number and make of all objects linked to a person card.<\/p>\n<h3>Share your ideas on email templates<\/h3>\n<p>Hopefully, these tips and tricks will make it easier to navigate the \u2018insert field\/list\u2019 menu and help you create your ideal e-mail template. If you have any suggestions on email templates, or you\u2019d like to share how you created your ideal template, let us know in the comments.<\/p>\n<p>Never want to miss out on important changes in TOPdesk software? Subscribe to the product update newsletter and you will receive compact emails with new feature highlights in TOPdesk.<\/p>\n<p><span id=\"hs-cta-wrapper-b3505662-1c85-427c-b08d-053ac4d1ccba\" class=\"hs-cta-wrapper\"><span id=\"hs-cta-b3505662-1c85-427c-b08d-053ac4d1ccba\" class=\"hs-cta-node hs-cta-b3505662-1c85-427c-b08d-053ac4d1ccba\" data-hs-drop=\"true\"><a id=\"cta_button_2232455_1c0cef64-9417-41bc-9368-c90836800265\" class=\"cta_button \" title=\"Subscribe to product update newsletter\" href=\"https:\/\/page.topdesk.com\/email-subscriptions\" target=\"_blank\" rel=\"noopener\">Subscribe to Product Update newsletter<\/a><\/span><\/span><\/p>\n<\/div>\n<div class=\"about-author-sec row-fluid\">\n<div class=\"span2\"><\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Have you always wondered what the [] insert field\/list is for? Or do you get intimidated by all the options in the pop up? In this post, we\u2019ll guide you through the jungle of insertion options. &nbsp; What do insertion fields do? Inserting a field is ideal for including card-specific information in emails. The insertion<\/p>\n","protected":false},"author":379,"featured_media":39408,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":"","inline_featured_image":false,"editor_notices":[],"footnotes":""},"class_list":["post-24550","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry"],"acf":{"blog_author":28080,"blog_hubspot_cta_link":"","toc_display":"full","blog_promotion_overwrite":false,"blog_promotion":false},"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v27.0 (Yoast SEO v27.0) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>Personalize your email templates with insertion fields | TOPdesk<\/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.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Personalize your email templates with insertion fields | Better support, happy customers | TOPdesk\" \/>\n<meta property=\"og:description\" content=\"Have you always wondered what the [] insert field\/list is for? Or do you get intimidated by all the options in the pop up? In this post, we\u2019ll guide you through the jungle of insertion options. &nbsp; What do insertion fields do? Inserting a field is ideal for including card-specific information in emails. The insertion\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/\" \/>\n<meta property=\"og:site_name\" content=\"T1 TOPdesk - EN\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/TOPdesk\/\" \/>\n<meta property=\"article:published_time\" content=\"2017-10-06T06:18:54+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-05-07T11:55:08+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/key-user-como-facilitar-a-rotina-desse-profissional.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"628\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Camille\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Camille\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/\"},\"author\":{\"name\":\"Camille\",\"@id\":\"https:\/\/www.topdesk.com\/en\/#\/schema\/person\/d5c66687e696681558408f7365411160\"},\"headline\":\"Personalize your email templates with insertion fields\",\"datePublished\":\"2017-10-06T06:18:54+00:00\",\"dateModified\":\"2025-05-07T11:55:08+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/\"},\"wordCount\":558,\"publisher\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/#organization\"},\"image\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/key-user-como-facilitar-a-rotina-desse-profissional.jpg\",\"articleSection\":[\"TOPdesk Product\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/\",\"url\":\"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/\",\"name\":\"Personalize your email templates with insertion fields | TOPdesk\",\"isPartOf\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/key-user-como-facilitar-a-rotina-desse-profissional.jpg\",\"datePublished\":\"2017-10-06T06:18:54+00:00\",\"dateModified\":\"2025-05-07T11:55:08+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/#primaryimage\",\"url\":\"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/key-user-como-facilitar-a-rotina-desse-profissional.jpg\",\"contentUrl\":\"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/key-user-como-facilitar-a-rotina-desse-profissional.jpg\",\"width\":1200,\"height\":628},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.topdesk.com\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Personalize your email templates with insertion fields\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.topdesk.com\/en\/#website\",\"url\":\"https:\/\/www.topdesk.com\/en\/\",\"name\":\"TOPdesk\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.topdesk.com\/en\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.topdesk.com\/en\/#organization\",\"name\":\"TOPdesk\",\"url\":\"https:\/\/www.topdesk.com\/en\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.topdesk.com\/en\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/TOPdesk_RGB_Logo.svg\",\"contentUrl\":\"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/TOPdesk_RGB_Logo.svg\",\"width\":1,\"height\":1,\"caption\":\"TOPdesk\"},\"image\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/TOPdesk\/\",\"https:\/\/www.instagram.com\/topdeskuk\/\",\"https:\/\/www.linkedin.com\/company\/topdesk\/\",\"https:\/\/www.youtube.com\/user\/topdesk\",\"https:\/\/en.wikipedia.org\/wiki\/TOPdesk\",\"https:\/\/www.gartner.com\/reviews\/market\/it-service-management-platforms\/vendor\/topdesk\",\"https:\/\/www.capterra.com\/p\/127562\/TOPdesk\/\",\"https:\/\/www.trustradius.com\/products\/topdesk\/reviews\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.topdesk.com\/en\/#\/schema\/person\/d5c66687e696681558408f7365411160\",\"name\":\"Camille\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.topdesk.com\/en\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/536b583efa467323a58b4378dcc4db34502b8a97a3ce830f171429d920e09488?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/536b583efa467323a58b4378dcc4db34502b8a97a3ce830f171429d920e09488?s=96&d=mm&r=g\",\"caption\":\"Camille\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Personalize your email templates with insertion fields | TOPdesk","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.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/","og_locale":"en_US","og_type":"article","og_title":"Personalize your email templates with insertion fields | Better support, happy customers | TOPdesk","og_description":"Have you always wondered what the [] insert field\/list is for? Or do you get intimidated by all the options in the pop up? In this post, we\u2019ll guide you through the jungle of insertion options. &nbsp; What do insertion fields do? Inserting a field is ideal for including card-specific information in emails. The insertion","og_url":"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/","og_site_name":"T1 TOPdesk - EN","article_publisher":"https:\/\/www.facebook.com\/TOPdesk\/","article_published_time":"2017-10-06T06:18:54+00:00","article_modified_time":"2025-05-07T11:55:08+00:00","og_image":[{"width":1200,"height":628,"url":"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/key-user-como-facilitar-a-rotina-desse-profissional.jpg","type":"image\/jpeg"}],"author":"Camille","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Camille","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/#article","isPartOf":{"@id":"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/"},"author":{"name":"Camille","@id":"https:\/\/www.topdesk.com\/en\/#\/schema\/person\/d5c66687e696681558408f7365411160"},"headline":"Personalize your email templates with insertion fields","datePublished":"2017-10-06T06:18:54+00:00","dateModified":"2025-05-07T11:55:08+00:00","mainEntityOfPage":{"@id":"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/"},"wordCount":558,"publisher":{"@id":"https:\/\/www.topdesk.com\/en\/#organization"},"image":{"@id":"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/#primaryimage"},"thumbnailUrl":"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/key-user-como-facilitar-a-rotina-desse-profissional.jpg","articleSection":["TOPdesk Product"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/","url":"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/","name":"Personalize your email templates with insertion fields | TOPdesk","isPartOf":{"@id":"https:\/\/www.topdesk.com\/en\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/#primaryimage"},"image":{"@id":"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/#primaryimage"},"thumbnailUrl":"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/key-user-como-facilitar-a-rotina-desse-profissional.jpg","datePublished":"2017-10-06T06:18:54+00:00","dateModified":"2025-05-07T11:55:08+00:00","breadcrumb":{"@id":"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/#primaryimage","url":"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/key-user-como-facilitar-a-rotina-desse-profissional.jpg","contentUrl":"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/key-user-como-facilitar-a-rotina-desse-profissional.jpg","width":1200,"height":628},{"@type":"BreadcrumbList","@id":"https:\/\/www.topdesk.com\/en\/blog\/insertion-fields-personalize-email-templates\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.topdesk.com\/en\/"},{"@type":"ListItem","position":2,"name":"Personalize your email templates with insertion fields"}]},{"@type":"WebSite","@id":"https:\/\/www.topdesk.com\/en\/#website","url":"https:\/\/www.topdesk.com\/en\/","name":"TOPdesk","description":"","publisher":{"@id":"https:\/\/www.topdesk.com\/en\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.topdesk.com\/en\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.topdesk.com\/en\/#organization","name":"TOPdesk","url":"https:\/\/www.topdesk.com\/en\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.topdesk.com\/en\/#\/schema\/logo\/image\/","url":"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/TOPdesk_RGB_Logo.svg","contentUrl":"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/TOPdesk_RGB_Logo.svg","width":1,"height":1,"caption":"TOPdesk"},"image":{"@id":"https:\/\/www.topdesk.com\/en\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/TOPdesk\/","https:\/\/www.instagram.com\/topdeskuk\/","https:\/\/www.linkedin.com\/company\/topdesk\/","https:\/\/www.youtube.com\/user\/topdesk","https:\/\/en.wikipedia.org\/wiki\/TOPdesk","https:\/\/www.gartner.com\/reviews\/market\/it-service-management-platforms\/vendor\/topdesk","https:\/\/www.capterra.com\/p\/127562\/TOPdesk\/","https:\/\/www.trustradius.com\/products\/topdesk\/reviews"]},{"@type":"Person","@id":"https:\/\/www.topdesk.com\/en\/#\/schema\/person\/d5c66687e696681558408f7365411160","name":"Camille","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.topdesk.com\/en\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/536b583efa467323a58b4378dcc4db34502b8a97a3ce830f171429d920e09488?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/536b583efa467323a58b4378dcc4db34502b8a97a3ce830f171429d920e09488?s=96&d=mm&r=g","caption":"Camille"}}]}},"_links":{"self":[{"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/posts\/24550","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/users\/379"}],"replies":[{"embeddable":true,"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/comments?post=24550"}],"version-history":[{"count":8,"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/posts\/24550\/revisions"}],"predecessor-version":[{"id":43206,"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/posts\/24550\/revisions\/43206"}],"acf:post":[{"embeddable":true,"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/person\/28080"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/media\/39408"}],"wp:attachment":[{"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/media?parent=24550"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}