{"id":50030,"date":"2026-06-24T14:32:47","date_gmt":"2026-06-24T18:32:47","guid":{"rendered":"https:\/\/docs.gravityforms.com\/?p=50030"},"modified":"2026-06-24T15:37:51","modified_gmt":"2026-06-24T19:37:51","slug":"international-phone-field","status":"publish","type":"post","link":"https:\/\/docs.gravityforms.com\/international-phone-field\/","title":{"rendered":"International Phone Field"},"content":{"rendered":"\n<pre class=\"wp-block-rocketgenius-editor-comments\"><span class=\"dashicons dashicons-admin-comments\"><\/span><b>Dario:<\/b>&nbsp;https:\/\/github.com\/gravityforms\/support-backlog\/issues\/1902<\/pre>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-overview\">Overview<\/h2>\n\n\n\n<p>Gravity Forms 3.0 includes significant improvements to the <a href=\"https:\/\/docs.gravityforms.com\/phone\/\" type=\"post\" id=\"6752\">Phone Field<\/a> when offering international phone number formats. It has been enhanced with improved accessibility, clearer labeling, and better visual design. These updates make it easier for users to select their country and enter phone numbers, while maintaining semantic HTML structure.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><a href=\"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2026\/06\/image-13.png\"><img loading=\"lazy\" decoding=\"async\" width=\"1000\" height=\"872\" src=\"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2026\/06\/image-13.png\" alt=\"Image showing the new International (formatted) phone field in the form editor\" class=\"wp-image-50047\" style=\"width:400px\" srcset=\"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2026\/06\/image-13.png 1000w, https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2026\/06\/image-13-300x262.png 300w, https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2026\/06\/image-13-768x670.png 768w\" sizes=\"auto, (max-width: 1000px) 100vw, 1000px\" \/><\/a><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-what-s-new\">What&#8217;s New<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-visible-sub-labels\">Visible Sub-Labels<\/h3>\n\n\n\n<p>Country selection and phone input now display visible sub-labels, making it clear what each field represents. You can customize these labels in the form editor using the Sub-Labels setting.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-improved-field-structure\">Improved Field Structure<\/h3>\n\n\n\n<p>The field now uses semantic HTML. The field wrapper changed from a <code>div<\/code> to a <code>fieldset<\/code>, and the field label changed from a <code>label<\/code> to a <code>legend<\/code>. This provides a better structure for assistive technologies.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-country-search-accessibility\">Country Search Accessibility<\/h3>\n\n\n\n<p>When users search for a country in the dropdown, a <code>aria-live<\/code> region announces the number of results found, helping screen reader users navigate the list more efficiently.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-enhanced-visual-design\">Enhanced Visual Design<\/h3>\n\n\n\n<p>The &#8220;no countries found&#8221; message now uses a text color that meets WCAG color contrast standards for improved readability.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-where-to-find-it\">Where to Find It<\/h2>\n\n\n\n<p>These improvements apply only to the&nbsp;International (Formatted)&nbsp;phone format. Access the updated sub-label settings in the form editor under the Phone field&#8217;s General Settings.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><a href=\"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2026\/06\/image-12.png\"><img loading=\"lazy\" decoding=\"async\" width=\"720\" height=\"696\" src=\"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2026\/06\/image-12.png\" alt=\"Image showing the new International (formatted) phone field settings\" class=\"wp-image-50035\" style=\"width:400px\" srcset=\"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2026\/06\/image-12.png 720w, https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2026\/06\/image-12-300x290.png 300w\" sizes=\"auto, (max-width: 720px) 100vw, 720px\" \/><\/a><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>The International (Formatted) phone field now features visible sub-labels, improved accessibility with semantic HTML structure, live search result announcements, and enhanced color contrast for better usability.<\/p>\n","protected":false},"author":52,"featured_media":0,"comment_status":"closed","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":["Content Word Count","SEO Title Length","Category Assigned","Internal Links","Alt Text for All Images"]},"categories":[19541],"tags":[],"class_list":["post-50030","post","type-post","status-publish","format-standard","hentry","category-gravity-forms-3-0","wpautop"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v27.9 (Yoast SEO v27.9) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>International Phone Field - Gravity Forms Documentation<\/title>\n<meta name=\"description\" content=\"The International (Formatted) phone field now features visible sub-labels, improved accessibility with semantic HTML structure, live search result announcements, and enhanced color contrast for better usability.\" \/>\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\/international-phone-field\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"International Phone Field\" \/>\n<meta property=\"og:description\" content=\"The International (Formatted) phone field now features visible sub-labels, improved accessibility with semantic HTML structure, live search result announcements, and enhanced color contrast for better usability.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.gravityforms.com\/international-phone-field\/\" \/>\n<meta property=\"og:site_name\" content=\"Gravity Forms Documentation\" \/>\n<meta property=\"article:published_time\" content=\"2026-06-24T18:32:47+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-06-24T19:37:51+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2026\/06\/image-13.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1000\" \/>\n\t<meta property=\"og:image:height\" content=\"872\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Dario\" \/>\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=\"Dario\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/international-phone-field\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/international-phone-field\\\/\"},\"author\":{\"name\":\"Dario\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#\\\/schema\\\/person\\\/acf2ff624683e2d7264ba969921fd50e\"},\"headline\":\"International Phone Field\",\"datePublished\":\"2026-06-24T18:32:47+00:00\",\"dateModified\":\"2026-06-24T19:37:51+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/international-phone-field\\\/\"},\"wordCount\":203,\"publisher\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/international-phone-field\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/docs.gravityforms.com\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/image-13.png\",\"articleSection\":[\"Gravity Forms 3.0 (beta)\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/international-phone-field\\\/\",\"url\":\"https:\\\/\\\/docs.gravityforms.com\\\/international-phone-field\\\/\",\"name\":\"International Phone Field - Gravity Forms Documentation\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/international-phone-field\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/international-phone-field\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/docs.gravityforms.com\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/image-13.png\",\"datePublished\":\"2026-06-24T18:32:47+00:00\",\"dateModified\":\"2026-06-24T19:37:51+00:00\",\"description\":\"The International (Formatted) phone field now features visible sub-labels, improved accessibility with semantic HTML structure, live search result announcements, and enhanced color contrast for better usability.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/international-phone-field\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/docs.gravityforms.com\\\/international-phone-field\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/international-phone-field\\\/#primaryimage\",\"url\":\"https:\\\/\\\/docs.gravityforms.com\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/image-13.png\",\"contentUrl\":\"https:\\\/\\\/docs.gravityforms.com\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/image-13.png\",\"width\":1000,\"height\":872},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/international-phone-field\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/docs.gravityforms.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"International Phone Field\"}]},{\"@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\\\/acf2ff624683e2d7264ba969921fd50e\",\"name\":\"Dario\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/b04dae864801947724ed88af0a96d38fc6068202143a3524df343d2858de9023?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/b04dae864801947724ed88af0a96d38fc6068202143a3524df343d2858de9023?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/b04dae864801947724ed88af0a96d38fc6068202143a3524df343d2858de9023?s=96&d=mm&r=g\",\"caption\":\"Dario\"},\"url\":\"https:\\\/\\\/docs.gravityforms.com\\\/author\\\/darion\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"International Phone Field - Gravity Forms Documentation","description":"The International (Formatted) phone field now features visible sub-labels, improved accessibility with semantic HTML structure, live search result announcements, and enhanced color contrast for better usability.","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\/international-phone-field\/","og_locale":"en_US","og_type":"article","og_title":"International Phone Field","og_description":"The International (Formatted) phone field now features visible sub-labels, improved accessibility with semantic HTML structure, live search result announcements, and enhanced color contrast for better usability.","og_url":"https:\/\/docs.gravityforms.com\/international-phone-field\/","og_site_name":"Gravity Forms Documentation","article_published_time":"2026-06-24T18:32:47+00:00","article_modified_time":"2026-06-24T19:37:51+00:00","og_image":[{"width":1000,"height":872,"url":"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2026\/06\/image-13.png","type":"image\/png"}],"author":"Dario","twitter_card":"summary_large_image","twitter_creator":"@gravityforms","twitter_site":"@gravityforms","twitter_misc":{"Written by":"Dario","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/docs.gravityforms.com\/international-phone-field\/#article","isPartOf":{"@id":"https:\/\/docs.gravityforms.com\/international-phone-field\/"},"author":{"name":"Dario","@id":"https:\/\/docs.gravityforms.com\/#\/schema\/person\/acf2ff624683e2d7264ba969921fd50e"},"headline":"International Phone Field","datePublished":"2026-06-24T18:32:47+00:00","dateModified":"2026-06-24T19:37:51+00:00","mainEntityOfPage":{"@id":"https:\/\/docs.gravityforms.com\/international-phone-field\/"},"wordCount":203,"publisher":{"@id":"https:\/\/docs.gravityforms.com\/#organization"},"image":{"@id":"https:\/\/docs.gravityforms.com\/international-phone-field\/#primaryimage"},"thumbnailUrl":"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2026\/06\/image-13.png","articleSection":["Gravity Forms 3.0 (beta)"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/docs.gravityforms.com\/international-phone-field\/","url":"https:\/\/docs.gravityforms.com\/international-phone-field\/","name":"International Phone Field - Gravity Forms Documentation","isPartOf":{"@id":"https:\/\/docs.gravityforms.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/docs.gravityforms.com\/international-phone-field\/#primaryimage"},"image":{"@id":"https:\/\/docs.gravityforms.com\/international-phone-field\/#primaryimage"},"thumbnailUrl":"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2026\/06\/image-13.png","datePublished":"2026-06-24T18:32:47+00:00","dateModified":"2026-06-24T19:37:51+00:00","description":"The International (Formatted) phone field now features visible sub-labels, improved accessibility with semantic HTML structure, live search result announcements, and enhanced color contrast for better usability.","breadcrumb":{"@id":"https:\/\/docs.gravityforms.com\/international-phone-field\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.gravityforms.com\/international-phone-field\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.gravityforms.com\/international-phone-field\/#primaryimage","url":"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2026\/06\/image-13.png","contentUrl":"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2026\/06\/image-13.png","width":1000,"height":872},{"@type":"BreadcrumbList","@id":"https:\/\/docs.gravityforms.com\/international-phone-field\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.gravityforms.com\/"},{"@type":"ListItem","position":2,"name":"International Phone Field"}]},{"@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\/acf2ff624683e2d7264ba969921fd50e","name":"Dario","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/b04dae864801947724ed88af0a96d38fc6068202143a3524df343d2858de9023?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/b04dae864801947724ed88af0a96d38fc6068202143a3524df343d2858de9023?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/b04dae864801947724ed88af0a96d38fc6068202143a3524df343d2858de9023?s=96&d=mm&r=g","caption":"Dario"},"url":"https:\/\/docs.gravityforms.com\/author\/darion\/"}]}},"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/pdGaEa-d0W","_links":{"self":[{"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/posts\/50030","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\/52"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/comments?post=50030"}],"version-history":[{"count":15,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/posts\/50030\/revisions"}],"predecessor-version":[{"id":50075,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/posts\/50030\/revisions\/50075"}],"wp:attachment":[{"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/media?parent=50030"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/categories?post=50030"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/tags?post=50030"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}