{"id":20821,"date":"2018-10-11T11:45:36","date_gmt":"2018-10-11T15:45:36","guid":{"rendered":"https:\/\/docs.gravityforms.com\/?p=20821"},"modified":"2019-09-12T12:41:33","modified_gmt":"2019-09-12T16:41:33","slug":"gform_personal_data_identification_fields","status":"publish","type":"post","link":"https:\/\/docs.gravityforms.com\/gform_personal_data_identification_fields\/","title":{"rendered":"gform_personal_data_identification_fields"},"content":{"rendered":"<h2 id=\"h-description\">Description<\/h2>\n<p>Allows the list of customer identification fields (in Personal Data settings) to be modified. When configuring the Exporting and Erasing Data setting on the Personal Data settings page, this list is displayed in a drop-down and allows an administrator to select one of the available fields to serve as a customer identifier when exporting and erasing customer data.<\/p>\n<p>By default, all email fields are automatically added as identification fields. If you have any field in your form that holds a User ID value, you can use this hook to add those fields to the list.<\/p>\n<p>These choices appear in the Identification Field drop down on the Personal Data settings page.<\/p>\n<h2 id=\"h-usage\">Usage<\/h2>\n<p>The following would apply to all forms:<\/p>\n<pre class=\"brush: php; title: ; notranslate\" title=\"\">\r\nadd_filter( 'gform_personal_data_identification_fields', 'your_function_name', 10, 2 );\r\n<\/pre>\n<p>To target a specific form, append the form id to the hook name. (format: gform_personal_data_identification_fields_FORMID)<\/p>\n<pre class=\"brush: php; title: ; notranslate\" title=\"\">\r\nadd_filter( 'gform_personal_data_identification_fields_1', 'your_function_name', 10, 2 );\r\n<\/pre>\n<div class=\"gf-docs-parameters\">\n<h2 id=\"h-parameters\">Parameters<\/h2>\n<ul>\n<li><strong>$identification_field_choices<\/strong> <a data-autolink=\"autolink_array\" href=\"\/array\">array<\/a>\n<p>An associative array with the field id as the key and the field label as the value.<\/p>\n<\/li>\n<li>\n<p><strong>$form<\/strong> <a data-autolink=\"autolink_form-object\" href=\"\/form-object\">Form Object<\/a><\/p>\n<p>The current form.<\/p>\n<\/li>\n<\/ul>\n<\/div>\n<h2 id=\"h-examples\">Examples<\/h2>\n<p>The example below adds the &#8220;created_by&#8221; field as a choice for the identification field.<\/p>\n<pre class=\"brush: php; title: ; notranslate\" title=\"\">\r\nadd_filter( 'gform_personal_data_identification_fields', 'add_fields', 10, 2 );\r\nfunction add_fields( $identification_field_choices, $form ){\r\n\t$identification_field_choices&#x5B;'created_by'] = 'Created By';\r\n\treturn $identification_field_choices;\r\n}\r\n<\/pre>\n<h2 id=\"h-placement\">Placement<\/h2>\n<p>This code should be placed in the <a href=\"http:\/\/codex.wordpress.org\/Theme_Development#Functions_File\">functions.php<\/a> file of your active theme.<\/p>\n<h2 id=\"h-since\">Since<\/h2>\n<p>This filter was added in Gravity Forms 2.4.<\/p>\n<h2 id=\"h-source-code\">Source Code<\/h2>\n<p>This filter is located in GF_Personal_Data::form_settings() in <em>gravityforms\/includes\/class-personal-data.php<\/em>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The &#8220;gform_personal_data_identification_fields&#8221; filter in Gravity Forms allows the list of personal data identification field choices to be modified.<\/p>\n","protected":false},"author":8,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_autodraft_ids":[],"_sb_is_suggestion_mode":false,"_sb_show_suggestion_boards":false,"_sb_show_comment_boards":false,"_sb_suggestion_history":"","_sb_update_block_changes":"","_is_real_time_mode":false,"_realtime_collaborators":"","footnotes":"","jetpack_post_was_ever_published":false,"cf_checklist_status":[]},"categories":[221],"tags":[8155],"class_list":["post-20821","post","type-post","status-publish","format-standard","hentry","category-entry-filters","tag-gf2-4","wpautop"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v27.4 (Yoast SEO v27.7) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>gform_personal_data_identification_fields - Gravity Forms<\/title>\n<meta name=\"description\" content=\"The &quot;gform_personal_data_identification_fields&quot; filter in Gravity Forms allows the list of personal data identification field choices to be modified.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/docs.gravityforms.com\/gform_personal_data_identification_fields\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"gform_personal_data_identification_fields\" \/>\n<meta property=\"og:description\" content=\"The &quot;gform_personal_data_identification_fields&quot; filter in Gravity Forms allows the list of personal data identification field choices to be modified.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.gravityforms.com\/gform_personal_data_identification_fields\/\" \/>\n<meta property=\"og:site_name\" content=\"Gravity Forms Documentation\" \/>\n<meta property=\"article:published_time\" content=\"2018-10-11T15:45:36+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2019-09-12T16:41:33+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2023\/08\/gf-docs-default-v3.png\" \/>\n\t<meta property=\"og:image:width\" content=\"544\" \/>\n\t<meta property=\"og:image:height\" content=\"288\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Dana Cobb\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@gravityforms\" \/>\n<meta name=\"twitter:site\" content=\"@gravityforms\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Dana Cobb\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/gform_personal_data_identification_fields\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/gform_personal_data_identification_fields\\\/\"},\"author\":{\"name\":\"Dana Cobb\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#\\\/schema\\\/person\\\/beaae56b85ba225a12574df6462534a2\"},\"headline\":\"gform_personal_data_identification_fields\",\"datePublished\":\"2018-10-11T15:45:36+00:00\",\"dateModified\":\"2019-09-12T16:41:33+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/gform_personal_data_identification_fields\\\/\"},\"wordCount\":281,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#organization\"},\"keywords\":[\"GF2.4\"],\"articleSection\":[\"Entry Filters\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/docs.gravityforms.com\\\/gform_personal_data_identification_fields\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/gform_personal_data_identification_fields\\\/\",\"url\":\"https:\\\/\\\/docs.gravityforms.com\\\/gform_personal_data_identification_fields\\\/\",\"name\":\"gform_personal_data_identification_fields - Gravity Forms\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#website\"},\"datePublished\":\"2018-10-11T15:45:36+00:00\",\"dateModified\":\"2019-09-12T16:41:33+00:00\",\"description\":\"The \\\"gform_personal_data_identification_fields\\\" filter in Gravity Forms allows the list of personal data identification field choices to be modified.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/gform_personal_data_identification_fields\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/docs.gravityforms.com\\\/gform_personal_data_identification_fields\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/gform_personal_data_identification_fields\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/docs.gravityforms.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"gform_personal_data_identification_fields\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#website\",\"url\":\"https:\\\/\\\/docs.gravityforms.com\\\/\",\"name\":\"Gravity Forms Documentation\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/docs.gravityforms.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#organization\",\"name\":\"Gravity Forms\",\"url\":\"https:\\\/\\\/docs.gravityforms.com\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/docs.gravityforms.com\\\/wp-content\\\/uploads\\\/2020\\\/01\\\/gravity-forms-2020-logo-stacked.png\",\"contentUrl\":\"https:\\\/\\\/docs.gravityforms.com\\\/wp-content\\\/uploads\\\/2020\\\/01\\\/gravity-forms-2020-logo-stacked.png\",\"width\":392,\"height\":515,\"caption\":\"Gravity Forms\"},\"image\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/x.com\\\/gravityforms\",\"http:\\\/\\\/@gravityforms.com\"]},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#\\\/schema\\\/person\\\/beaae56b85ba225a12574df6462534a2\",\"name\":\"Dana Cobb\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/87159a8d6cbc1039e002872cc7c3574cec6c0bba5c8b22e97bfd900f2cd03d95?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/87159a8d6cbc1039e002872cc7c3574cec6c0bba5c8b22e97bfd900f2cd03d95?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/87159a8d6cbc1039e002872cc7c3574cec6c0bba5c8b22e97bfd900f2cd03d95?s=96&d=mm&r=g\",\"caption\":\"Dana Cobb\"},\"url\":\"https:\\\/\\\/docs.gravityforms.com\\\/author\\\/danacobb\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"gform_personal_data_identification_fields - Gravity Forms","description":"The \"gform_personal_data_identification_fields\" filter in Gravity Forms allows the list of personal data identification field choices to be modified.","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:\/\/docs.gravityforms.com\/gform_personal_data_identification_fields\/","og_locale":"en_US","og_type":"article","og_title":"gform_personal_data_identification_fields","og_description":"The \"gform_personal_data_identification_fields\" filter in Gravity Forms allows the list of personal data identification field choices to be modified.","og_url":"https:\/\/docs.gravityforms.com\/gform_personal_data_identification_fields\/","og_site_name":"Gravity Forms Documentation","article_published_time":"2018-10-11T15:45:36+00:00","article_modified_time":"2019-09-12T16:41:33+00:00","og_image":[{"width":544,"height":288,"url":"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2023\/08\/gf-docs-default-v3.png","type":"image\/png"}],"author":"Dana Cobb","twitter_card":"summary_large_image","twitter_creator":"@gravityforms","twitter_site":"@gravityforms","twitter_misc":{"Written by":"Dana Cobb","Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/docs.gravityforms.com\/gform_personal_data_identification_fields\/#article","isPartOf":{"@id":"https:\/\/docs.gravityforms.com\/gform_personal_data_identification_fields\/"},"author":{"name":"Dana Cobb","@id":"https:\/\/docs.gravityforms.com\/#\/schema\/person\/beaae56b85ba225a12574df6462534a2"},"headline":"gform_personal_data_identification_fields","datePublished":"2018-10-11T15:45:36+00:00","dateModified":"2019-09-12T16:41:33+00:00","mainEntityOfPage":{"@id":"https:\/\/docs.gravityforms.com\/gform_personal_data_identification_fields\/"},"wordCount":281,"commentCount":0,"publisher":{"@id":"https:\/\/docs.gravityforms.com\/#organization"},"keywords":["GF2.4"],"articleSection":["Entry Filters"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/docs.gravityforms.com\/gform_personal_data_identification_fields\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/docs.gravityforms.com\/gform_personal_data_identification_fields\/","url":"https:\/\/docs.gravityforms.com\/gform_personal_data_identification_fields\/","name":"gform_personal_data_identification_fields - Gravity Forms","isPartOf":{"@id":"https:\/\/docs.gravityforms.com\/#website"},"datePublished":"2018-10-11T15:45:36+00:00","dateModified":"2019-09-12T16:41:33+00:00","description":"The \"gform_personal_data_identification_fields\" filter in Gravity Forms allows the list of personal data identification field choices to be modified.","breadcrumb":{"@id":"https:\/\/docs.gravityforms.com\/gform_personal_data_identification_fields\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.gravityforms.com\/gform_personal_data_identification_fields\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.gravityforms.com\/gform_personal_data_identification_fields\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.gravityforms.com\/"},{"@type":"ListItem","position":2,"name":"gform_personal_data_identification_fields"}]},{"@type":"WebSite","@id":"https:\/\/docs.gravityforms.com\/#website","url":"https:\/\/docs.gravityforms.com\/","name":"Gravity Forms Documentation","description":"","publisher":{"@id":"https:\/\/docs.gravityforms.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.gravityforms.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/docs.gravityforms.com\/#organization","name":"Gravity Forms","url":"https:\/\/docs.gravityforms.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.gravityforms.com\/#\/schema\/logo\/image\/","url":"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2020\/01\/gravity-forms-2020-logo-stacked.png","contentUrl":"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2020\/01\/gravity-forms-2020-logo-stacked.png","width":392,"height":515,"caption":"Gravity Forms"},"image":{"@id":"https:\/\/docs.gravityforms.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/x.com\/gravityforms","http:\/\/@gravityforms.com"]},{"@type":"Person","@id":"https:\/\/docs.gravityforms.com\/#\/schema\/person\/beaae56b85ba225a12574df6462534a2","name":"Dana Cobb","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/87159a8d6cbc1039e002872cc7c3574cec6c0bba5c8b22e97bfd900f2cd03d95?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/87159a8d6cbc1039e002872cc7c3574cec6c0bba5c8b22e97bfd900f2cd03d95?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/87159a8d6cbc1039e002872cc7c3574cec6c0bba5c8b22e97bfd900f2cd03d95?s=96&d=mm&r=g","caption":"Dana Cobb"},"url":"https:\/\/docs.gravityforms.com\/author\/danacobb\/"}]}},"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/pdGaEa-5pP","_links":{"self":[{"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/posts\/20821","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/users\/8"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/comments?post=20821"}],"version-history":[{"count":1,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/posts\/20821\/revisions"}],"predecessor-version":[{"id":20916,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/posts\/20821\/revisions\/20916"}],"wp:attachment":[{"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/media?parent=20821"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/categories?post=20821"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/tags?post=20821"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}