The information in this wiki hasn't been maintained for a good while. Some of the projects described have since been deprecated.

In particular, the "Ushahidi Platform v3.x" section contains information that is often misleading. Many details about this version of Platform have changed since.

This website is an extraction of the original Ushahidi wiki into a static form. Because of that, functions like logging in, commenting or searching will not work.

For more documentation, please refer to

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


New tickets on github for Ushahidi platform,   Request for help on Crowdmap (private repo)

Layers and Crowdmap

Crowdmap allows for KML file uploads as "Layers" on our map -- Layers are contextual information available as an overlay to the reports.  If organizations are looking to import data points from KML files act active reports within Ushahidi, that is not an option.  The CSV format is currently our only option for that.

WMS Layers

What is it?

"A Web Map Service (WMS) is a standard protocol for serving georeferenced map images over the Internet that are generated by a map server using data from a GIS database"


Metacarta example plugin

KML Layers

What is it?

KML is an XML based format for geographic data, most notably used by Google Maps and Google Earth. More info:


  • KML layers from other domains not loading.
    This could be Issue #231.
    As part of browser security policies, some domains will not allow requests direct from other domains.
    Theres no simple way around this: Try downloading the KML and uploading the file directly into Ushahidi, rather than including it from the URL.
  • Invalid KML layers
    Check: Can you load this KML layer in google maps? (goto and paste the url into the search box)
    Can you load this KML layer in google earth?
    If either of these do not work, the layer is unlikely to work in Ushahidi
  • Overly complex KML
    For some reason, complex KML files cause issues with Ushahidi. This is probably because all the rendering happen in the browser, and its simply too slow.
    If you have a KML with lots of features, one work around is to load this into Google Earth and export the KML layer into multiple different KML layers.
    Loading these separately may be more successful.
  • There may still be an issue with KML layers in IE Issues #324
  • OpenLayers doesn't support GroundOverlay tags in KML files
    See and for more info


KML related plugins

  • KML on by default
    Lets you set any KML layers to be displayed by default on the homepage ushahidi map
  • KML plugin
    Generate KML output from Ushahidi reports

Google Earth Layers