This plugin is available for accounts with Silver, Gold, and Platinum plans.

The Geolocation plugin allows you to assign a location to items in your Omeka site. The locations are displayed on maps on individual items page and on a browsable map of all geolocated items.

There is a screencast for Geolocation (version 2.2.4) demonstrating its basic functionality.


Once you have installed the Geolocation plugin, go to the Plugins tab in the top navigation of your admin dashboard. Scroll down to the listing for Geolocation and click Configure (if you do not see Configure you may need to click the Install or Activate buttons.

General Settings

The first section for configuration are the general settings for the appearance of your map on the public and admin sides of your site.

General settings for geolocation

If you select Mapbox from the dropdown for Base Map, two additional fields will appear under general settings.

You can use MapBox to create your own map tiles, for example a historic map layer. Please refer to the MapBox documentation for more information.

The dropdown for Base Map with MapBox selected is at the top, with the two fields described following. Both fields are empty.

Browse Map Settings

These settings are for the map through which users can browse all geolocated items, and for the “Search by Address function” that Geolocation enables in advanced item search.

Browse map settings for geolocation

A map with Enable marker clusters unchecked:
A low-detail map showing the British Isles, with a number of blue map markers throughout England

The same map with Enable marker clusters checked:
A low-detail map of the British Isles, with one blue map marker in southwest England and a yellow circle with the label 17 roughly over London

Item Map Settings

These settings are for the map display on an item/show page.

Item Map settings

Map Integration

These settings are for integration of the geolocation map into the site menu and the contribution plugin’s form.

Map Integration settings

Getting Started

After you have activated and configured the Geolocation plugin, it is time to geolocate some items.

Geolocation adds a Map tab to the options for adding or editing an item (admin/item/add and admin/item/edit pages). When adding metadata for an item, click on the Map tab to add a location.

Locating the map tab on the admin item edit

On the tab there is a field for you to find a location by address and a map which you can drag to move around, zoom in and out with the plus and minus options (or the scroll wheel on a mouse), and toggle between road and satellite maps.

Enter the address where you want the marker for the item to be placed. The plugin will automatically add a marker at that location.

You can also click directly on the spot on the map where you want to place the marker. A marker automatically maps the selected site.

To change the location of an item, type in the new address or click on the new location. You’ll be asked if you are sure you would like to change the item location. Select OK or Cancel.

To remove geolocation from an item, click directly on the marker. A dialog box will ask you to confirm that you want to delete the location assignment. Don’t forget to save your changes.

Viewing Items on the Public Map

Visitors to your Omeka site may use a map to browse through all of your geolocated items.

When configuring the plugin, if you selected “Add Link to Map on Items/Browse Navigation,” a “Browse Map” link will be added automatically to the secondary navigation on the items/browse page.


From this view, visitors may browse all mapped items, browse by tag, search for items and browse the map.

They may also locate a mapped item by clicking on the items listed in the right column of the map.

Browse and Search Items on Admin Map

A Map tab appears in the left navigation bar located on the left side of the Dashboard. Clicking on the Map tab takes you to a map that displays all items geolocated in your Omeka site–public and not public, and an advanced search form to locate specific items.


From this view, you may also search mapped items using the item advanced search. Search results appear directly on the map.