Skip to content

Using Humap

Overlays and overlay groups

This tutorial is available in video and text/image.

Overlays are geo-rectified historical/antique maps or statistical data, layered on top of the base map.

Here are some examples of overlays.

At present, creating an overlay takes some work from our team. We are provided with a map – these are usually large scale scans. These are then geo-rectified in a program called MapTiler and exported out as tile sets which are hosted on Amazon S3. Creating an overlay & overlay group in the CMS points to these tiles.

From this dashboard you can edit or delete existing overlays and create new ones.

A screenshot of Overlays section on the admin dashboard

How to add new overlays:

  • Click New Overlay.

A screenshot of Overlays / Basic content on the admin dashboard

  • Add a name and a URL for the overlay.
  • Use the Overlay Groups box to tag it with any relevant overlay groups.
  • If you would like to create an overlay group with the same name, click the Yes checkbox next to the question.
  • Use the Overlay Type checkboxes to signify if the overlay uses raster or vector data.
    • Rasters are image files, which are typically scans of historic hand drawn maps. Vectors are mathematical points that represent data on the map and will have associated metadata such as identification number, title, description, taxonomies.
  • When you’re finished on this page, click Date and Location in the overlay toolbar.

A screenshot of Overlays / Date and Location on the admin dashboard

  • Does your overlay have dates? If so, you can write them in the Date From (start date) and Date To (end date). You can also click the calendar icon at the end of the text box to select a date from there.
  • Your overlay pin needs a location. You can use the text box in the map to search (via postcode or place name) or use latitude and longitude.
  • When you’ve found the location, click the map to drop the red pin.
  • When you’re happy with the location, click Categories.

A screenshot of Overlays / Categories on the admin dashboard

  • Tick the appropriate boxes for your overlay.
  • Remember, you can come back and edit this at any point.
  • Your overlay is complete! This is how it will look on the map:

A screenshot of a finished overlay

Click here to see the map in situ!


Overlays can also be grouped along a similar theme or topic.

Here is the overlay group dashboard. Here you can edit and delete existing overlay groups and create new ones.

A screenshot of the Overlay Groups section of the admin dashboard

  • To create a new overlay group, click New Overlay Group.

A screenshot of Overlay Groups / Edit Overlay Group on the admin dashboard

  • Add a title into the Title Text Box. The slug (URL) will auto-generated based on your title.
  • If you aren’t happy with the slug, click Edit Slug to change it.
  • Click Choose File and upload a representative image of your overlay group. Name it in the box below.

A screenshot of Overlay group / content on the admin dashboard

  • The Content text box will be the description of your collection’s content. Use the formatting options in the toolbar to make your text pop, and remember to use frequent paragraph breaks!
  • The Excerpt will show on the preview of your collection, so it’s best to sum up your collection with something that will make other people click on it.
  • click the Overlays text box beneath the Excerpt box. This will create a drop down menu with a list of available overlays.
  • Click the overlays relevant to this list.
  • Done!

Send a message

How can we help?

We usually respond in a few hours