{"id":48086,"date":"2026-06-24T14:20:58","date_gmt":"2026-06-24T18:20:58","guid":{"rendered":"https:\/\/docs.gravityforms.com\/?p=48086"},"modified":"2026-06-24T14:21:05","modified_gmt":"2026-06-24T18:21:05","slug":"gform-phone-countries","status":"publish","type":"post","link":"https:\/\/docs.gravityforms.com\/gform-phone-countries\/","title":{"rendered":"gform\/phone\/countries"},"content":{"rendered":"\n
<\/span>Dario:<\/b>\u00a0https:\/\/github.com\/gravityforms\/support-backlog\/issues\/1498<\/pre>\n\n\n\n
Introduction<\/h2>\n\n\n\n
The gform\/phone\/countries<\/code> filter allows you to customize the countries list displayed in the international phone field. This filter provides access to the countries array before the phone field is initialized, enabling you to filter which countries appear in the dropdown, reorder them to prioritize specific regions, or combine both approaches.<\/p>\n\n\n\n
Parameters<\/p>\n\n\n\n
Name<\/th>Type<\/th>Description<\/th><\/tr><\/thead>
data<\/code><\/td>object<\/a><\/td>An object containing the countries array and form\/field context.<\/td><\/tr>
data.countries<\/code><\/td>array<\/a><\/td>Array of country objects, each with properties like iso2<\/code>, name<\/code>, and dialCode<\/code>.<\/td><\/tr>
data.formId<\/code><\/td>number<\/a><\/td>The ID of the form containing the phone field.<\/td><\/tr>
data.fieldId<\/code><\/td>number<\/a><\/td>The ID of the phone field being filtered.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Examples<\/h2>\n\n\n\n
Filter Countries.<\/h3>\n\n\n\n
The example below shows how to limit the countries list to only show the United States, Canada, and Mexico. This approach filters the existing countries array to include only the specified country codes.<\/p>\n\n\n
\ngform.utils.addFilter( 'gform\/phone\/countries', function( data ) {\n    var allowedCountries = [ 'us', 'ca', 'mx' ];\n    data.countries = data.countries.filter( function( country ) {\n        return allowedCountries.indexOf( country.iso2 ) !== -1;\n    } );\n    return data;\n} );\n<\/pre><\/div>\n\n\n
Reorder Countries.<\/h3>\n\n\n\n
The example below demonstrates how to prioritize specific countries at the top of the list while maintaining all other countries below. In this case, Mexico, Canada, and the United States appear first in that specific order, followed by all remaining countries in their default order.<\/p>\n\n\n
\ngform.utils.addFilter( 'gform\/phone\/countries', function( data ) {\n    var priorityCountries = [ 'mx', 'ca', 'us' ];\n    var priority = [];\n    var rest = [];\n\n    data.countries.forEach( function( country ) {\n        if ( priorityCountries.indexOf( country.iso2 ) !== -1 ) {\n            priority.push( country );\n        } else {\n            rest.push( country );\n        }\n    } );\n\n    \/\/ Make priority countries have the same order as in the priorityCountries array\n    priority.sort( function( a, b ) {\n        return priorityCountries.indexOf( a.iso2 ) - priorityCountries.indexOf( b.iso2 );\n    } );\n\n    data.countries = priority.concat( rest );\n    return data;\n} );\n<\/pre><\/div>\n\n\n
\n
Placement<\/h2>\n\n\n\n
Reference the article Adding JavaScript Code to the Frontend of Your Site<\/a>.<\/p>\n<\/div><\/div>\n\n\n\n
Source Code<\/h2>\n\n\n\n
This filter is located in assets\/js\/src\/theme\/fields\/international-phone\/core\/model.js<\/p>\n\n\n\n
Since<\/h2>\n\n\n\n
This filter was added in Gravity Forms 3.0.0<\/p>\n","protected":false},"excerpt":{"rendered":"
The gform\/phone\/countries filter allows you to customize the countries list displayed in the international phone field.<\/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":["SEO Title Length","Alt Text for All Images","Category Assigned","Content Word Count","Internal Links"]},"categories":[210],"tags":[],"class_list":["post-48086","post","type-post","status-publish","format-standard","hentry","category-javascript","wpautop"],"acf":[],"yoast_head":"\ngform\/phone\/countries - Gravity Forms Documentation<\/title>\n<meta name=\"description\" content=\"The gform\/phone\/countries filter allows you to customize the countries list displayed in the international phone field.\" \/>\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-phone-countries\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"gform\/phone\/countries\" \/>\n<meta property=\"og:description\" content=\"The gform\/phone\/countries filter allows you to customize the countries list displayed in the international phone field.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.gravityforms.com\/gform-phone-countries\/\" \/>\n<meta property=\"og:site_name\" content=\"Gravity Forms Documentation\" \/>\n<meta property=\"article:published_time\" content=\"2026-06-24T18:20:58+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-06-24T18:21:05+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=\"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\\\/gform-phone-countries\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/gform-phone-countries\\\/\"},\"author\":{\"name\":\"Dario\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#\\\/schema\\\/person\\\/acf2ff624683e2d7264ba969921fd50e\"},\"headline\":\"gform\\\/phone\\\/countries\",\"datePublished\":\"2026-06-24T18:20:58+00:00\",\"dateModified\":\"2026-06-24T18:21:05+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/gform-phone-countries\\\/\"},\"wordCount\":204,\"publisher\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#organization\"},\"articleSection\":[\"JavaScript\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/gform-phone-countries\\\/\",\"url\":\"https:\\\/\\\/docs.gravityforms.com\\\/gform-phone-countries\\\/\",\"name\":\"gform\\\/phone\\\/countries - Gravity Forms Documentation\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#website\"},\"datePublished\":\"2026-06-24T18:20:58+00:00\",\"dateModified\":\"2026-06-24T18:21:05+00:00\",\"description\":\"The gform\\\/phone\\\/countries filter allows you to customize the countries list displayed in the international phone field.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/gform-phone-countries\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/docs.gravityforms.com\\\/gform-phone-countries\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/gform-phone-countries\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/docs.gravityforms.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"gform\\\/phone\\\/countries\"}]},{\"@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":"gform\/phone\/countries - Gravity Forms Documentation","description":"The gform\/phone\/countries filter allows you to customize the countries list displayed in the international phone field.","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-phone-countries\/","og_locale":"en_US","og_type":"article","og_title":"gform\/phone\/countries","og_description":"The gform\/phone\/countries filter allows you to customize the countries list displayed in the international phone field.","og_url":"https:\/\/docs.gravityforms.com\/gform-phone-countries\/","og_site_name":"Gravity Forms Documentation","article_published_time":"2026-06-24T18:20:58+00:00","article_modified_time":"2026-06-24T18:21:05+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":"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\/gform-phone-countries\/#article","isPartOf":{"@id":"https:\/\/docs.gravityforms.com\/gform-phone-countries\/"},"author":{"name":"Dario","@id":"https:\/\/docs.gravityforms.com\/#\/schema\/person\/acf2ff624683e2d7264ba969921fd50e"},"headline":"gform\/phone\/countries","datePublished":"2026-06-24T18:20:58+00:00","dateModified":"2026-06-24T18:21:05+00:00","mainEntityOfPage":{"@id":"https:\/\/docs.gravityforms.com\/gform-phone-countries\/"},"wordCount":204,"publisher":{"@id":"https:\/\/docs.gravityforms.com\/#organization"},"articleSection":["JavaScript"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/docs.gravityforms.com\/gform-phone-countries\/","url":"https:\/\/docs.gravityforms.com\/gform-phone-countries\/","name":"gform\/phone\/countries - Gravity Forms Documentation","isPartOf":{"@id":"https:\/\/docs.gravityforms.com\/#website"},"datePublished":"2026-06-24T18:20:58+00:00","dateModified":"2026-06-24T18:21:05+00:00","description":"The gform\/phone\/countries filter allows you to customize the countries list displayed in the international phone field.","breadcrumb":{"@id":"https:\/\/docs.gravityforms.com\/gform-phone-countries\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.gravityforms.com\/gform-phone-countries\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.gravityforms.com\/gform-phone-countries\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.gravityforms.com\/"},{"@type":"ListItem","position":2,"name":"gform\/phone\/countries"}]},{"@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-cvA","_links":{"self":[{"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/posts\/48086","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=48086"}],"version-history":[{"count":5,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/posts\/48086\/revisions"}],"predecessor-version":[{"id":48091,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/posts\/48086\/revisions\/48091"}],"wp:attachment":[{"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/media?parent=48086"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/categories?post=48086"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/tags?post=48086"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}