{"id":7936,"date":"2021-11-06T15:35:20","date_gmt":"2021-11-06T15:35:20","guid":{"rendered":"http:\/\/3.26.62.22\/?post_type=ht_kb&#038;p=7936"},"modified":"2021-11-06T15:35:31","modified_gmt":"2021-11-06T15:35:31","slug":"custom-fields","status":"publish","type":"ht_kb","link":"http:\/\/help.gjgardner.com\/au\/hc\/setup\/contact-settings\/custom-fields\/","title":{"rendered":"Custom Fields"},"content":{"rendered":"<p><span style=\"font-weight: 400;\">You can manage custom fields for specific contact types. This way you can track additional information about contacts within their profiles.<\/span><\/p>\n\n\n\n<ol class=\"wp-block-list\"><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">To manage custom fields, on the navigational sidebar, select <\/span><b>Setup<\/b><span style=\"font-weight: 400;\">.<\/span><\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Once the Setup section expands, select <\/span><b>Contacts<\/b><span style=\"font-weight: 400;\">.<\/span><\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">On the tabbed menu, select <\/span><b>Custom Fields<\/b><span style=\"font-weight: 400;\">.<\/span><\/li><\/ol>\n\n\n\n<p>The Custom Fields page opens, as follows:<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img loading=\"lazy\" decoding=\"async\" width=\"1493\" height=\"799\" src=\"https:\/\/builder-help.gjgardner.com\/wp-content\/uploads\/2019\/03\/setup-contacts-custom-fields.png\" alt=\"\" class=\"wp-image-702\" srcset=\"https:\/\/help.gjgardner.com\/wp-content\/uploads\/2019\/03\/setup-contacts-custom-fields.png 1493w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2019\/03\/setup-contacts-custom-fields-300x161.png 300w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2019\/03\/setup-contacts-custom-fields-1024x548.png 1024w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2019\/03\/setup-contacts-custom-fields-768x411.png 768w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2019\/03\/setup-contacts-custom-fields-1200x642.png 1200w\" sizes=\"(max-width: 1493px) 100vw, 1493px\" \/><\/figure><\/div>\n\n\n\n<p><span style=\"font-weight: 400;\">Here you can see the list of custom fields registered in the system. For each custom field, the following information is available:<\/span><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><b>Field Name<\/b><\/td><td><span style=\"font-weight: 400;\">Name of the custom field.<\/span><\/td><\/tr><tr><td><b>Contact Type<\/b><\/td><td><span style=\"font-weight: 400;\">Type of the contact which the custom fields attributes to.<\/span><\/td><\/tr><tr><td><b>Field type<\/b><\/td><td><span style=\"font-weight: 400;\">Type of the custom field.<\/span><\/td><\/tr><tr><td><b>Digits\/Length<\/b><\/td><td><span style=\"font-weight: 400;\">Maximal number of digits\/characters which the field can store. This information varies depending on the field type.<\/span><\/td><\/tr><tr><td><b>Decimal Places<\/b><\/td><td><span style=\"font-weight: 400;\">Number of decimal places. This information is available for the number field only.<\/span><\/td><\/tr><tr><td><b>Required<\/b><\/td><td><span style=\"font-weight: 400;\">Flag that the field is required. If no flag is shown, the custom field is optional.<\/span><\/td><\/tr><tr><td><b>Status<\/b><\/td><td><span style=\"font-weight: 400;\">A red label indicating that the custom field is deactivated. No label is shown for active custom fields.<\/span><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><span style=\"font-weight: 400;\">You can perform the following operations on custom fields:<\/span><\/p>\n\n\n\n<ul class=\"wp-block-list\"><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">create new custom fields<\/span><\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">edit the existing custom fields<\/span><\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">deactivate the no longer needed custom fields<\/span><\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">activate the deactivated custom fields<\/span><\/li><\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><b>Creating a Custom Text Field<\/b><\/h3>\n\n\n\n<ol class=\"wp-block-list\"><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">On the <\/span><b>Custom Fields<\/b><span style=\"font-weight: 400;\"> tab, above the list of custom fields, click the <\/span><b>Add&nbsp;<img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-204 alignnone\" src=\"https:\/\/builder-help.gjgardner.com\/wp-content\/uploads\/2019\/02\/create-icon.png\" alt=\"\" width=\"15\" height=\"20\"><\/b> <span style=\"font-weight: 400;\"> icon.<\/span><\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">In the <\/span><b>Create new custom field<\/b><span style=\"font-weight: 400;\"> form, specify the following information:<\/span><br>\n<table>\n<tbody>\n<tr>\n<td><b>Contact Type<\/b><\/td>\n<td><span style=\"font-weight: 400;\">Select the contact type which the custom field attributes to.<\/span><\/td>\n<\/tr>\n<tr>\n<td><b>Field name<\/b><\/td>\n<td><span style=\"font-weight: 400;\">Enter the name of the custom field.<\/span><\/td>\n<\/tr>\n<tr>\n<td><b>Field<\/b> <b>type<\/b><\/td>\n<td><span style=\"font-weight: 400;\">Select \u2018Text\u2019 from the list of options.<\/span><\/td>\n<\/tr>\n<tr>\n<td><b>Length<\/b><\/td>\n<td><span style=\"font-weight: 400;\">Specify the maximal length of the custom field.<\/span><\/td>\n<\/tr>\n<tr>\n<td><b>Required<\/b><\/td>\n<td><span style=\"font-weight: 400;\">Check the box to make the custom field as required.<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<figure><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-704\" src=\"https:\/\/builder-help.gjgardner.com\/wp-content\/uploads\/2019\/03\/create-custom-field-text.png\" alt=\"\" width=\"380\" height=\"451\" srcset=\"https:\/\/help.gjgardner.com\/wp-content\/uploads\/2019\/03\/create-custom-field-text.png 380w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2019\/03\/create-custom-field-text-253x300.png 253w\" sizes=\"(max-width: 380px) 100vw, 380px\" \/><\/figure><p><\/p>\n<\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">When complete, click <\/span><b>Save<\/b><span style=\"font-weight: 400;\">.<\/span><\/li><\/ol>\n\n\n\n<h3 class=\"wp-block-heading\"><b>Creating a Custom Date Field<\/b><\/h3>\n\n\n\n<ol class=\"wp-block-list\"><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">On the <\/span><b>Custom Fields<\/b><span style=\"font-weight: 400;\"> tab, above the list of custom fields, click the <\/span><b>Add&nbsp;<img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-204 alignnone\" src=\"https:\/\/builder-help.gjgardner.com\/wp-content\/uploads\/2019\/02\/create-icon.png\" alt=\"\" width=\"15\" height=\"20\"><\/b> <span style=\"font-weight: 400;\"> icon.<\/span><\/li><li style=\"font-weight: 400;\">In the <b>Create new custom field<\/b> form, specify the following information:<br>\n<table>\n<tbody>\n<tr>\n<td><b>Contact Type<\/b><\/td>\n<td><span style=\"font-weight: 400;\">Select the contact type which the custom field attributes to.<\/span><\/td>\n<\/tr>\n<tr>\n<td><b>Field name<\/b><\/td>\n<td><span style=\"font-weight: 400;\">Enter the name of the custom field.<\/span><\/td>\n<\/tr>\n<tr>\n<td><b>Field<\/b> <b>type<\/b><\/td>\n<td><span style=\"font-weight: 400;\">Select \u2018Date\u2019 from the list of options.<\/span><\/td>\n<\/tr>\n<tr>\n<td><b>Required<\/b><\/td>\n<td><span style=\"font-weight: 400;\">Check the box to make the custom field as required.<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<figure><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-705\" src=\"https:\/\/builder-help.gjgardner.com\/wp-content\/uploads\/2019\/03\/create-custom-field-date.png\" alt=\"\" width=\"380\" height=\"450\" srcset=\"https:\/\/help.gjgardner.com\/wp-content\/uploads\/2019\/03\/create-custom-field-date.png 380w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2019\/03\/create-custom-field-date-253x300.png 253w\" sizes=\"(max-width: 380px) 100vw, 380px\" \/><\/figure><p><\/p>\n<\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">When complete, click <\/span><b>Save<\/b><span style=\"font-weight: 400;\">.<\/span><\/li><\/ol>\n\n\n\n<h3 class=\"wp-block-heading\"><b>Creating a Custom Number Field<\/b><\/h3>\n\n\n\n<ol class=\"wp-block-list\"><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">On the <\/span><b>Custom Fields<\/b><span style=\"font-weight: 400;\"> tab, above the list of custom fields, click the <\/span><b>Add&nbsp;<img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-204 alignnone\" src=\"https:\/\/builder-help.gjgardner.com\/wp-content\/uploads\/2019\/02\/create-icon.png\" alt=\"\" width=\"15\" height=\"20\"><\/b> <span style=\"font-weight: 400;\"> icon.<\/span><\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">In the <\/span><b>Create new custom field<\/b><span style=\"font-weight: 400;\"> form, specify the following information:<\/span><br>\n<table>\n<tbody>\n<tr>\n<td><b>Contact Type<\/b><\/td>\n<td><span style=\"font-weight: 400;\">Select the contact type which the custom field attributes to.<\/span><\/td>\n<\/tr>\n<tr>\n<td><b>Field name<\/b><\/td>\n<td><span style=\"font-weight: 400;\">Enter the name of the custom field.<\/span><\/td>\n<\/tr>\n<tr>\n<td><b>Field<\/b> <b>type<\/b><\/td>\n<td><span style=\"font-weight: 400;\">Select \u2018Number\u2019 from the list of options.<\/span><\/td>\n<\/tr>\n<tr>\n<td><b>Digits<\/b><\/td>\n<td><span style=\"font-weight: 400;\">Specify the number of allowed digits in the custom field. The decimal places are counted towards the number of digits in the custom field.<\/span><\/td>\n<\/tr>\n<tr>\n<td><b>Decimal places<\/b><\/td>\n<td><span style=\"font-weight: 400;\">Specify the number of decimal places.<\/span><\/td>\n<\/tr>\n<tr>\n<td><b>Required<\/b><\/td>\n<td><span style=\"font-weight: 400;\">Check the box to make the custom field as required.<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<figure><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-706\" src=\"https:\/\/builder-help.gjgardner.com\/wp-content\/uploads\/2019\/03\/create-custom-field-number.png\" alt=\"\" width=\"380\" height=\"451\" srcset=\"https:\/\/help.gjgardner.com\/wp-content\/uploads\/2019\/03\/create-custom-field-number.png 380w, https:\/\/help.gjgardner.com\/wp-content\/uploads\/2019\/03\/create-custom-field-number-253x300.png 253w\" sizes=\"(max-width: 380px) 100vw, 380px\" \/><\/figure><p><\/p>\n<\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">When complete, click <\/span><b>Save<\/b><span style=\"font-weight: 400;\">.<\/span><\/li><\/ol>\n\n\n\n<h3 class=\"wp-block-heading\"><b>Editing the Custom Field<\/b><\/h3>\n\n\n\n<p><span style=\"font-weight: 400;\">You can edit the existing custom fields, but you can update the field name and set the field as required or optional. The rest of modifications (such as change of the field type or its length) are not allowed.<\/span><\/p>\n\n\n\n<ol class=\"wp-block-list\"><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">On the list with custom fields, locate the one you want to edit.<\/span><\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Hover over the custom field until the action icons appear.<\/span><\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Click the <\/span><b>Edit&nbsp;<img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-188 alignnone\" src=\"https:\/\/builder-help.gjgardner.com\/wp-content\/uploads\/2019\/02\/edit-icon.png\" alt=\"\" width=\"15\" height=\"15\"><\/b> <span style=\"font-weight: 400;\"> icon.<\/span><\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">In the <\/span><b>Edit custom field<\/b><span style=\"font-weight: 400;\"> form, make the appropriate modifications.<\/span><\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">When complete, click <\/span><b>Save<\/b><span style=\"font-weight: 400;\">.<\/span><\/li><\/ol>\n\n\n\n<h3 class=\"wp-block-heading\"><b>Deactivating the Custom Field<\/b><\/h3>\n\n\n\n<p><span style=\"font-weight: 400;\">You can temporarily deactivate custom fields, so they will no longer appear on the Custom Fields tab in contacts of a specific type. Values of the deactivated custom field will be retained after its activation.<\/span><\/p>\n\n\n\n<ol class=\"wp-block-list\"><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">On the list with custom fields, locate the one you want to deactivate.<\/span><\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Hover over the custom field until the action icons appear.<\/span><\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Click the <\/span><b>Deactivate&nbsp;<img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-558 alignnone\" src=\"https:\/\/builder-help.gjgardner.com\/wp-content\/uploads\/2019\/03\/undelete-icon.png\" alt=\"\" width=\"12\" height=\"16\"><\/b> <span style=\"font-weight: 400;\"> icon.<\/span><\/li><\/ol>\n\n\n\n<h3 class=\"wp-block-heading\"><b>Activating the Custom Field<\/b><\/h3>\n\n\n\n<p><span style=\"font-weight: 400;\">You can activate the temporarily deactivated custom fields, so they will again appear on the Custom Fields tab in contacts of a specific type.<\/span><\/p>\n\n\n\n<ol class=\"wp-block-list\"><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">On the list with custom fields, locate the one you want to activate.<\/span><\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Hover over the custom field until the action icons appear.<\/span><\/li><li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Click the <\/span><b>Activate&nbsp;<img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-557 alignnone\" src=\"https:\/\/builder-help.gjgardner.com\/wp-content\/uploads\/2019\/03\/mark-deleted-icon.png\" alt=\"\" width=\"18\" height=\"14\"><\/b> <span style=\"font-weight: 400;\"> icon.<\/span><\/li><\/ol>","protected":false},"excerpt":{"rendered":"<p>You can manage custom fields for specific contact types. This way you can track additional information about contacts within their profiles. To manage custom fields, on the navigational sidebar, select Setup. Once the Setup section expands, select Contacts. On the tabbed menu, select Custom Fields. The Custom Fields page opens,&#8230;<\/p>","protected":false},"author":21,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[214],"ht-kb-tag":[],"class_list":["post-7936","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-contact-settings"],"_links":{"self":[{"href":"https:\/\/help.gjgardner.com\/au\/wp-json\/wp\/v2\/ht-kb\/7936"}],"collection":[{"href":"https:\/\/help.gjgardner.com\/au\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/help.gjgardner.com\/au\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/help.gjgardner.com\/au\/wp-json\/wp\/v2\/users\/21"}],"replies":[{"embeddable":true,"href":"https:\/\/help.gjgardner.com\/au\/wp-json\/wp\/v2\/comments?post=7936"}],"version-history":[{"count":1,"href":"https:\/\/help.gjgardner.com\/au\/wp-json\/wp\/v2\/ht-kb\/7936\/revisions"}],"predecessor-version":[{"id":7937,"href":"https:\/\/help.gjgardner.com\/au\/wp-json\/wp\/v2\/ht-kb\/7936\/revisions\/7937"}],"wp:attachment":[{"href":"https:\/\/help.gjgardner.com\/au\/wp-json\/wp\/v2\/media?parent=7936"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/help.gjgardner.com\/au\/wp-json\/wp\/v2\/ht-kb-category?post=7936"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/help.gjgardner.com\/au\/wp-json\/wp\/v2\/ht-kb-tag?post=7936"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}