Phone number

Make phone numbers searchable formatted or unformatted

  • Author: Allan Jardine

Telephone numbers are a common data point to display in HTML tables, and are often formatted (e.g. 555-1234). Typically, when searching a table a user would need to enter the number in exactly the same format it is displayed in, but this is not always convenient (e.g. you might search for 5551).

This filtering plug-in will allow both forms to be matched be providing both the formatted and de-formatted data to the table's search.


This plug-in can be obtained and used in multiple different ways.


This plug-in is available on the DataTables CDN:


The plug-in will then automatically register itself against a global DataTables instance. This file can also be used if you are using an AMD loader such as Require.js.

Note that if you are using multiple plug-ins, it can be beneficial in terms of performance to combine the plug-ins into a single file and host it on your own server, rather than making multiple requests to the DataTables CDN.


The plug-ins are all available on NPM (which can also be used with Yarn or any other Javascript package manager) as part of the package. To use this plug-in, first install the plug-ins package:

npm install

ES modules

Then, if you are using ES modules, import, any other DataTables extensions you need, and the plug-in:

import DataTable from '';
import '';


If you are using a CommonJS loader for Node (e.g. with older versions of Webpack, or non-module Node code) use the following method to require the plug-in:

var $ = require('jquery');
var DataTable = require('');


$(document).ready(function() {
    $('#example').dataTable( {
      columnDefs: [
        { type: 'phoneNumber', target: 4 }
    } );
  } );

Version control

If you have any ideas for how this plug-in can be improved, or spot anything that is in error, it is available on GitHub and pull requests are very welcome!