{"id":163283,"date":"2022-10-01T04:32:24","date_gmt":"2022-10-01T04:32:24","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/telephone-input-for-contact-form-7\/"},"modified":"2026-06-29T09:55:24","modified_gmt":"2026-06-29T09:55:24","slug":"telephone-input-for-contact-form-7","status":"publish","type":"plugin","link":"https:\/\/pt.wordpress.org\/plugins\/telephone-input-for-contact-form-7\/","author":20419894,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0","stable_tag":"trunk","tested":"7.0.2","requires":"5.5","requires_php":"7.0","requires_plugins":null,"header_name":"Telephone Input For Contact form 7","header_author":"","header_description":"This plugin allows quickly search and select a country Telephone from a responsive, mobile-friendly flag dropdown.","assets_banners_color":"fbfbfe","last_updated":"2026-06-29 09:55:24","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":600,"downloads":5406,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.0":"<p>Initial release. Install and start collecting validated international phone numbers inside your Contact Form 7 forms today. Upgrade to Pro for country whitelisting, preferred countries pinning, and country exclusion features.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3475278,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3475278,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3475278,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3475278,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":2792768,"resolution":"1","location":"assets","locale":"","width":1905,"height":902},"screenshot-2.png":{"filename":"screenshot-2.png","revision":2792768,"resolution":"2","location":"assets","locale":"","width":1900,"height":902},"screenshot-3.png":{"filename":"screenshot-3.png","revision":2792768,"resolution":"3","location":"assets","locale":"","width":1915,"height":887},"screenshot-4.png":{"filename":"screenshot-4.png","revision":2792768,"resolution":"4","location":"assets","locale":"","width":1177,"height":867}},"screenshots":{"1":"CF7 form editor \u2014 \"telephone_input\" tag button highlighted in the form toolbar","2":"CF7 form template \u2014 generated [telephone_input] shortcode tag shown in the form body","3":"Form-tag Generator modal \u2014 name, ID, class, only\/preferred\/exclude countries, and Insert Tag button","4":"Front-end contact form \u2014 telephone input with country flag, dial code dropdown listing countries with flags and codes"}},"plugin_section":[],"plugin_tags":[1152,37323,269446,149230,269445],"plugin_category":[],"plugin_contributors":[256981],"plugin_business_model":[],"class_list":["post-163283","plugin","type-plugin","status-publish","hentry","plugin_tags-contact-form-7","plugin_tags-country-flag","plugin_tags-international-phone","plugin_tags-phone-field","plugin_tags-telephone-input","plugin_contributors-howdytheme","plugin_committers-howdytheme"],"banners":{"banner":"https:\/\/ps.w.org\/telephone-input-for-contact-form-7\/assets\/banner-772x250.png?rev=3475278","banner_2x":"https:\/\/ps.w.org\/telephone-input-for-contact-form-7\/assets\/banner-1544x500.png?rev=3475278","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/telephone-input-for-contact-form-7\/assets\/icon-128x128.png?rev=3475278","icon_2x":"https:\/\/ps.w.org\/telephone-input-for-contact-form-7\/assets\/icon-256x256.png?rev=3475278","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/telephone-input-for-contact-form-7\/assets\/screenshot-1.png?rev=2792768","caption":"CF7 form editor \u2014 \"telephone_input\" tag button highlighted in the form toolbar"},{"src":"https:\/\/ps.w.org\/telephone-input-for-contact-form-7\/assets\/screenshot-2.png?rev=2792768","caption":"CF7 form template \u2014 generated [telephone_input] shortcode tag shown in the form body"},{"src":"https:\/\/ps.w.org\/telephone-input-for-contact-form-7\/assets\/screenshot-3.png?rev=2792768","caption":"Form-tag Generator modal \u2014 name, ID, class, only\/preferred\/exclude countries, and Insert Tag button"},{"src":"https:\/\/ps.w.org\/telephone-input-for-contact-form-7\/assets\/screenshot-4.png?rev=2792768","caption":"Front-end contact form \u2014 telephone input with country flag, dial code dropdown listing countries with flags and codes"}],"raw_content":"<!--section=description-->\n<p><strong>Telephone Input For Contact Form 7<\/strong> is a free WordPress plugin that adds a professional international telephone input field to any Contact Form 7 form. The field features a searchable, mobile-friendly country flag dropdown that automatically detects and prefixes the correct international dial code \u2014 giving your forms a polished, globally-ready phone number input with zero configuration.<\/p>\n\n<p>Standard Contact Form 7 phone fields accept any text, leaving you with inconsistent, unformatted, and unvalidated phone number submissions. This plugin solves that problem by replacing the plain phone input with a fully-featured international telephone field backed by the intl-tel-input library \u2014 the same library trusted by thousands of production applications worldwide.<\/p>\n\n<blockquote>\n  <p><strong>Requires Contact Form 7<\/strong> to be installed and activated on your WordPress site.<\/p>\n<\/blockquote>\n\n<p><a href=\"https:\/\/topsmodule.com\/how-to-create-telephone-input-for-contact-form-7\/\">\ud83d\udcc4 Documentation<\/a> | <a href=\"https:\/\/topsmodule.com\/task\/telephone-input-for-contact-form-7\/\">\ud83d\udd34 Live Demo<\/a> | <a href=\"https:\/\/www.topsmodule.com\/product\/telephone-input-for-contact-form-7\/\">\u2b50 Get Pro Version<\/a><\/p>\n\n\n\n<h4>Why Use Telephone Input For Contact Form 7?<\/h4>\n\n<p>A plain text phone field collects messy, inconsistent data. Users format numbers differently, forget dial codes, or enter invalid values \u2014 and you end up with unusable contact data.<\/p>\n\n<p>This plugin replaces the guesswork with a structured international phone input. The country flag dropdown makes selecting a country instant and intuitive. The dial code is captured automatically and included in your email notification alongside the number the user typed. Phone format validation catches invalid entries before they reach your inbox. The result is cleaner leads, fewer invalid submissions, and a more professional form experience for your visitors.<\/p>\n\n\n\n<h4>Free Version Features<\/h4>\n\n<ul>\n<li><p><strong>International Telephone Input Field<\/strong> \u2014 Add a fully functional international phone number input to any Contact Form 7 form using the built-in tag generator. No coding required. The field is registered as a native CF7 form tag and works exactly like any other CF7 field.<\/p><\/li>\n<li><p><strong>Country Flag Dropdown<\/strong> \u2014 The telephone field includes a searchable flag dropdown listing all countries in the world. Users can scroll or type to find their country, making it fast and intuitive on both desktop and mobile.<\/p><\/li>\n<li><p><strong>Automatic Dial Code Detection<\/strong> \u2014 When a user selects a country from the dropdown, the international dial code for that country (e.g. +1 for the US, +44 for the UK, +91 for India) is automatically detected and stored. The dial code is captured separately and merged with the phone number before it is sent in your email notification.<\/p><\/li>\n<li><p><strong>Dial Code Included in Email Notification<\/strong> \u2014 The submitted phone number is automatically combined with the selected country dial code and delivered as a single formatted value in your Contact Form 7 email notification via the standard mail tag. No manual formatting or extra steps required.<\/p><\/li>\n<li><p><strong>Enable \/ Disable Country Dropdown<\/strong> \u2014 Control whether the country flag dropdown is displayed on the telephone field. When enabled, users can select their country and the dial code is applied. When disabled, the field renders as a plain international telephone input without the dropdown.<\/p><\/li>\n<li><p><strong>Phone Number Format Validation<\/strong> \u2014 Submitted values are validated on the server side against an international phone number pattern. Only properly formatted phone numbers (digits, spaces, hyphens, parentheses, and a leading + for the country code) are accepted. Invalid entries trigger a CF7 validation error and prevent form submission.<\/p><\/li>\n<li><p><strong>Required Field Support<\/strong> \u2014 Mark the telephone input field as required using the standard CF7 required field option. If a user submits the form without entering a phone number, submission is blocked and a validation error is shown.<\/p><\/li>\n<li><p><strong>Custom Field ID<\/strong> \u2014 Assign a custom HTML ID attribute to the telephone input field for targeting with CSS or JavaScript.<\/p><\/li>\n<li><p><strong>Custom CSS Class<\/strong> \u2014 Add one or more custom CSS class names to the telephone input field for flexible front-end styling without modifying plugin files.<\/p><\/li>\n<li><p><strong>Mail Tag Integration<\/strong> \u2014 Include the submitted phone number (with dial code) in your CF7 email notifications by inserting the corresponding mail tag into the Mail tab \u2014 the same way any other CF7 field works.<\/p><\/li>\n<li><p><strong>Mobile Friendly<\/strong> \u2014 The country flag dropdown and telephone input are fully responsive and work smoothly on smartphones and tablets of all screen sizes.<\/p><\/li>\n<li><p><strong>Works with All Recent CF7 Versions<\/strong> \u2014 Tested and compatible with Contact Form 7 up to version 7.0<\/p><\/li>\n<li><p><strong>Powered by intl-tel-input<\/strong> \u2014 Built on the widely trusted intl-tel-input JavaScript library, which is used in production by thousands of web applications globally.<\/p><\/li>\n<\/ul>\n\n\n\n<h4>Pro Version Features<\/h4>\n\n<p>The following features are available exclusively in the Pro version. They appear as disabled fields in the CF7 tag generator for free users.<\/p>\n\n<p><strong><a href=\"https:\/\/www.topsmodule.com\/product\/telephone-input-for-contact-form-7\/\">Upgrade to Pro \u2192<\/a><\/strong><\/p>\n\n<ul>\n<li><p><strong>Only Countries (Country Whitelist)<\/strong> \u2014 Restrict the country dropdown to show only a specific set of countries. Enter a hyphen-separated list of country codes (e.g. <code>us-ca-gb<\/code>) and the dropdown will display only those countries. Ideal for businesses that serve specific regions or want to limit submissions to particular markets.<\/p><\/li>\n<li><p><strong>Preferred Countries (Pin Countries to Top)<\/strong> \u2014 Specify one or more countries that should appear at the top of the dropdown list above all other countries. Enter country codes (e.g. <code>us-gb<\/code>) to promote them to the top position for faster selection. Perfect when your audience is primarily from one or two countries but you still want the full global list available below.<\/p><\/li>\n<li><p><strong>Exclude Countries (Country Blacklist)<\/strong> \u2014 Hide specific countries from the dropdown entirely. Enter a hyphen-separated list of country codes (e.g. <code>us-ca<\/code>) and those countries will be removed from the list. Useful for compliance requirements, regional restrictions, or simply keeping the dropdown tidy for your target audience.<\/p><\/li>\n<\/ul>\n\n\n\n<h4>Perfect For<\/h4>\n\n<ul>\n<li>Contact and enquiry forms that serve an international audience<\/li>\n<li>Lead generation forms where a valid phone number is required<\/li>\n<li>Booking, reservation, and appointment request forms<\/li>\n<li>eCommerce checkout or order enquiry forms<\/li>\n<li>Event registration forms collecting attendee contact details<\/li>\n<li>Any Contact Form 7 form where a clean, validated, international phone number field is needed<\/li>\n<\/ul>\n\n\n\n<h4>How It Works<\/h4>\n\n<ol>\n<li>Install and activate the plugin (Contact Form 7 must already be active).<\/li>\n<li>Open any Contact Form 7 form in the editor.<\/li>\n<li>Click <strong>Add Form Tag<\/strong> and select <strong>telephone_input<\/strong> from the list.<\/li>\n<li>In the tag generator panel, configure your field:\n\n<ul>\n<li>Tick <strong>This is a required field<\/strong> if the phone number must be entered before submission<\/li>\n<li>Enter a <strong>Name<\/strong> for the field (used for the mail tag)<\/li>\n<li>Optionally set a custom <strong>ID<\/strong> or <strong>Class<\/strong><\/li>\n<li>Check or uncheck <strong>Enable dropdown<\/strong> to control whether the country flag picker is shown<\/li>\n<\/ul><\/li>\n<li>Click <strong>Insert Tag<\/strong> to add the shortcode to your form.<\/li>\n<li>Go to the <strong>Mail<\/strong> tab and insert the mail tag (e.g. <code>[your-phone-field]<\/code>) wherever you want the phone number to appear in the notification email. The value will include the selected dial code and the number the user typed.<\/li>\n<li>Save the form. The international telephone input is now live on your site.<\/li>\n<\/ol>\n\n<!--section=installation-->\n<h4>Automatic Installation (Recommended)<\/h4>\n\n<ol>\n<li>Make sure <strong>Contact Form 7<\/strong> is installed and activated.<\/li>\n<li>In your WordPress dashboard, go to <strong>Plugins &gt; Add New<\/strong>.<\/li>\n<li>Search for <strong>Telephone Input For Contact Form 7<\/strong>.<\/li>\n<li>Click <strong>Install Now<\/strong>, then click <strong>Activate<\/strong>.<\/li>\n<\/ol>\n\n<h4>Manual Installation<\/h4>\n\n<ol>\n<li>Download the plugin ZIP file.<\/li>\n<li>Go to <strong>Plugins &gt; Add New &gt; Upload Plugin<\/strong> in your WordPress dashboard.<\/li>\n<li>Upload the ZIP file and click <strong>Install Now<\/strong>.<\/li>\n<li>Click <strong>Activate Plugin<\/strong> after installation.<\/li>\n<\/ol>\n\n<h4>After Activation<\/h4>\n\n<ol>\n<li>Open any Contact Form 7 form editor.<\/li>\n<li>Click <strong>Add Form Tag<\/strong> and select <strong>telephone_input<\/strong>.<\/li>\n<li>Configure the field options and click <strong>Insert Tag<\/strong>.<\/li>\n<li>Add the mail tag to your Mail tab template.<\/li>\n<li>Save and test your form.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20plugin%20require%20contact%20form%207%3F\"><h3>Does this plugin require Contact Form 7?<\/h3><\/dt>\n<dd><p>Yes. Contact Form 7 must be installed and activated for this plugin to work. The telephone input is registered as a custom CF7 form tag and relies entirely on the CF7 framework for rendering, validation, and email output.<\/p><\/dd>\n<dt id=\"does%20the%20submitted%20phone%20number%20include%20the%20country%20dial%20code%20in%20the%20email%3F\"><h3>Does the submitted phone number include the country dial code in the email?<\/h3><\/dt>\n<dd><p>Yes. When a user selects a country and enters their phone number, the plugin captures the international dial code (e.g. +44) and the phone number separately, then merges them into a single formatted value before it is sent via the CF7 mail tag. Your email notification will contain the full number including the dial code.<\/p><\/dd>\n<dt id=\"can%20i%20make%20the%20telephone%20field%20required%3F\"><h3>Can I make the telephone field required?<\/h3><\/dt>\n<dd><p>Yes. In the tag generator, tick the <strong>This is a required field<\/strong> checkbox. If a user submits the form without entering a phone number, validation will fail and an error message will be displayed \u2014 the same behaviour as any other required CF7 field.<\/p><\/dd>\n<dt id=\"is%20the%20phone%20number%20validated%20before%20submission%3F\"><h3>Is the phone number validated before submission?<\/h3><\/dt>\n<dd><p>Yes. The plugin includes server-side phone number format validation. It checks that the submitted value contains only valid phone number characters (digits, spaces, hyphens, parentheses, and an optional leading +). Invalid entries are rejected and a validation error is shown to the user.<\/p><\/dd>\n<dt id=\"can%20i%20disable%20the%20country%20flag%20dropdown%3F\"><h3>Can I disable the country flag dropdown?<\/h3><\/dt>\n<dd><p>Yes. In the tag generator, uncheck the <strong>Enable dropdown<\/strong> option. When disabled, the field renders as a plain international telephone text input without the country selector.<\/p><\/dd>\n<dt id=\"can%20i%20restrict%20the%20dropdown%20to%20only%20show%20certain%20countries%3F\"><h3>Can I restrict the dropdown to only show certain countries?<\/h3><\/dt>\n<dd><p>Restricting the dropdown to a specific list of countries (Only Countries \/ whitelist) is a <strong>Pro version feature<\/strong>. <a href=\"https:\/\/www.topsmodule.com\/product\/telephone-input-for-contact-form-7\/\">Upgrade here<\/a>.<\/p><\/dd>\n<dt id=\"can%20i%20pin%20certain%20countries%20to%20the%20top%20of%20the%20dropdown%3F\"><h3>Can I pin certain countries to the top of the dropdown?<\/h3><\/dt>\n<dd><p>Pinning preferred countries to the top of the list is a <strong>Pro version feature<\/strong>. <a href=\"https:\/\/www.topsmodule.com\/product\/telephone-input-for-contact-form-7\/\">Upgrade here<\/a>.<\/p><\/dd>\n<dt id=\"can%20i%20hide%20or%20remove%20specific%20countries%20from%20the%20dropdown%3F\"><h3>Can I hide or remove specific countries from the dropdown?<\/h3><\/dt>\n<dd><p>Excluding specific countries from the dropdown (blacklist) is a <strong>Pro version feature<\/strong>. <a href=\"https:\/\/www.topsmodule.com\/product\/telephone-input-for-contact-form-7\/\">Upgrade here<\/a>.<\/p><\/dd>\n<dt id=\"can%20i%20add%20a%20custom%20id%20or%20css%20class%20to%20the%20telephone%20field%3F\"><h3>Can I add a custom ID or CSS class to the telephone field?<\/h3><\/dt>\n<dd><p>Yes. Both a custom HTML ID and a custom CSS class can be set directly in the tag generator when creating the telephone input field.<\/p><\/dd>\n<dt id=\"is%20the%20field%20mobile-friendly%3F\"><h3>Is the field mobile-friendly?<\/h3><\/dt>\n<dd><p>Yes. The country flag dropdown and the telephone input are fully responsive and support touch interaction on all smartphones and tablets.<\/p><\/dd>\n<dt id=\"is%20the%20plugin%20compatible%20with%20the%20latest%20version%20of%20wordpress%20and%20contact%20form%207%3F\"><h3>Is the plugin compatible with the latest version of WordPress and Contact Form 7?<\/h3><\/dt>\n<dd><p>Yes. The plugin has been tested up to WordPress 7.0 and is compatible with all recent versions of Contact Form 7.<\/p><\/dd>\n<dt id=\"where%20can%20i%20find%20setup%20documentation%3F\"><h3>Where can I find setup documentation?<\/h3><\/dt>\n<dd><p>Full documentation and a step-by-step setup guide are available at (https:\/\/topsmodule.com\/how-to-create-telephone-input-for-contact-form-7\/).<\/p><\/dd>\n<dt id=\"where%20can%20i%20see%20a%20live%20demo%3F\"><h3>Where can I see a live demo?<\/h3><\/dt>\n<dd><p>You can view a live working demo at (https:\/\/topsmodule.com\/task\/telephone-input-for-contact-form-7\/).<\/p><\/dd>\n<dt id=\"how%20do%20i%20upgrade%20to%20the%20pro%20version%3F\"><h3>How do I upgrade to the Pro version?<\/h3><\/dt>\n<dd><p>Visit (https:\/\/www.topsmodule.com\/product\/telephone-input-for-contact-form-7\/) to get the Pro version and unlock country whitelisting, preferred countries, and country exclusion features.<\/p>\n\n<\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<li>Add international telephone input field to any Contact Form 7 form.<\/li>\n<li>Country flag dropdown with full worldwide country list.<\/li>\n<li>Automatic dial code detection and capture.<\/li>\n<li>Dial code merged with phone number in email notifications via mail tag.<\/li>\n<li>Enable \/ disable country dropdown option.<\/li>\n<li>Server-side phone number format validation.<\/li>\n<li>Required field support.<\/li>\n<li>Custom ID and CSS class attribute support.<\/li>\n<li>Mobile and touch-screen compatible.<\/li>\n<li>Built on the intl-tel-input library.<\/li>\n<\/ul>","raw_excerpt":"Add an international telephone input field with a country flag dropdown to any Contact Form 7 form. Includes dial code detection, phone validation, an &hellip;","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/163283","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pt.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pt.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=163283"}],"author":[{"embeddable":true,"href":"https:\/\/pt.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/howdytheme"}],"wp:attachment":[{"href":"https:\/\/pt.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=163283"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=163283"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=163283"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=163283"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=163283"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=163283"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}