This plugin allows you to include a small image or iframe in your website displaying the flags and total hits of the countries your website visitors came from

Please keep in mind that everyone will be able to see that kind of statistic as this plugin does not consider the access rights.


Matomo 2.0.4 or higher is required. GD library including ttf support.


  • Configurable with following parameters:
    • idSite: Website to display
    • period: period to display
    • date: date to display
    • cols: count of columns to display (default 2)
    • rows: count of rows to display (default 5)
    • showflag: show flags (default 1)
    • showcountryode: show country codes (default 0)
    • font: font family to use
    • fontsize: font size to use (between 2 and 30; default 12)
    • fontcolor: font color to use (rgb value; default 0,0,0)
  • Generates a transparent PNG image showing the flag icons and their total hits
  • Generates simple HTML to be included as iframe

View and download this plugin for a specific Matomo version:

The image is not displayed. What can I do?

Maybe you have some kind of access restriction for your Matomo like http auth. The Url needs to be public accessible, or at least accessible to those, who should be able to see the counter.

How can I display the counter for all data in the past

To do that, set period to range and date to something like 1992-01-01,today.

The full URL for the image would then look like:


This URL can then be simply used in an img tag on your site. e.g.

<img src="http://matomo.url/index.php?module=FlagCounter&action=image&idSite=1&period=range&date=1992-01-01,today&cols=2&rows=6" />

Can I use a custom font?

Currently all ttf fonts located in the fonts directory within this plugin are available for usage. If you place a new font there, you should be able to use it.

  • counter1

  • counter2

  • counter3

  • counter4

  • settings

View and download this plugin for a specific Matomo version:

Please share