ip2location facebbook  ip2location twitter  ip2location google+ ip2location github

IP2Location Matomo (Piwik) Plugin

This plugin converts visitor's IP address into geographical location such as country, region and city, using IP2Location BIN database. It offers you an accurate geolocation tracking compare to default geolocation installed that guess a visitor's country based on language they use.

The plugin works well with DB3.LITE (free) or DB3 (commercial).

Download IP2Location Matomo (Piwik) Plugin

This plugin works on Matomo (Piwik) version 2.12.0 and above.


  1. Download and decompress this Matomo (Piwik) plugin package.
  2. Copy the package, IP2Location folder, to /plugins/ in the server. Note: The folder name in the server must be named as IP2Location
  3. Download IP2Location database from DB3.LITE (free) or DB3 (commercial).
  4. Upload the database file (.BIN) into /plugins/IP2Location/data. Note: Please create the data folder if the folder doesn't exist.
  5. Login to Matomo (piwik) admin area.
  6. Click on Settings->Plugins menu.
  7. Search for IP2Location entry and activate the plugin by clicking on the Activate link.
  8. You're done.


Note: Please make sure you are using the Default geolocation option for our plugin to function correctly.
IP2Location Matomo (Piwik) plugin


If you successfully installed the plugin, you shall see the IP2Location under the Settings section, as shown in the below picture:
IP2Location Matomo (Piwik) settings

On the IP2Location, you are able to check if the plugin able to read the BIN file in the data table. In addition, you may also perform the lookup on this page.
IP2Location Matomo (Piwik) lookup


The plugin will start look up and display the geoloation information for the new visitors. Please take note that this plugin will not edit the geo location data recorded before this plugin installation.


IP2Location Report

This plugin has included one custom report allowing user to view the traffics of the below information:

You can view the report by clicking on the Visitors->IP2Location Report. Below are the screen shot of the custom report: IP2Location Report

You may need to install the below BIN database to display the relevant information.


Sample IP2Location Databases (BIN)

The following evaluation copy of the database file has limited range of IP address information compare to commercial. For evaluation purpose, you can query IP addresses from (IPv4) or 2A04:0:0:0:0:0:0:0-2A04:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF (IPv6).

Sample Packages IPv4 IPv6
IP2Location DB1 Sample Bin File679.73 kB350.84 kB
IP2Location DB2 Sample Bin File37.69 MB378.66 kB
IP2Location DB3 Sample Bin File19.55 MB363.65 kB
IP2Location DB4 Sample Bin File54.14 MB388.27 kB
IP2Location DB5 Sample Bin File29.71 MB370.18 kB
IP2Location DB6 Sample Bin File63.78 MB393.44 kB
IP2Location DB7 Sample Bin File60.12 MB398.64 kB
IP2Location DB8 Sample Bin File70.10 MB403.55 kB
IP2Location DB9 Sample Bin File34.33 MB373.45 kB
IP2Location DB10 Sample Bin File75.59 MB408.65 kB
IP2Location DB11 Sample Bin File35.01 MB374.17 kB
IP2Location DB12 Sample Bin File76.13 MB409.59 kB
IP2Location DB13 Sample Bin File33.51 MB371.65 kB
IP2Location DB14 Sample Bin File77.47 MB410.29 kB
IP2Location DB15 Sample Bin File37.98 MB378.07 kB
IP2Location DB16 Sample Bin File82.04 MB415.93 kB
IP2Location DB17 Sample Bin File40.49 MB380.09 kB
IP2Location DB18 Sample Bin File89.27 MB425.95 kB
IP2Location DB19 Sample Bin File72.85 MB404.88 kB
IP2Location DB20 Sample Bin File91.67 MB427.07 kB
IP2Location DB21 Sample Bin File41.36 MB380.72 kB
IP2Location DB22 Sample Bin File95.58 MB430.11 kB
IP2Location DB23 Sample Bin File73.31 MB405.90 kB
IP2Location DB24 Sample Bin File96.54 MB431.79 kB