FAQ content

Mapping: Add & edit interactive maps for space and seat bookings

Mapping is a paid add-on to LibCal that allows patrons to browse and book spaces & seats using an interactive floor plan map. 

Interested in adding Mapping to your LibCal subscription? Contact the Springy Sales Team for more info!

In this article

The LibCal Mapping module allows patrons to browse your available spaces and seats using an interactive floor plan map.

example of an interactive map
Maps have clickable areas called hotspots that are associated with spaces and seats in LibCal. Clicking one starts the booking process.
  • Each bookable space and seat will be color-coded to indicate its availability.
  • When a patron clicks on a space or seat, they'll be able to review its details (such as its description, space capacity, accessibility, etc.).
  • From there, a link will take them to the space or seat's booking page, where they can submit a booking.
  • The maps can help patrons easily locate the space or seat when they arrive for their bookings.

In this article, you'll learn how to set up your maps and associate them with a spaces and/or seats in a location or zone.

Step 1. Add maps to your LibCal system

LibCal Mapping is available as an add-on to your LibCal subscription. If you haven't yet signed up, please contact the Springy Sales Team to get started.

We'll work closely with you to generate the floor plan maps for your site and define which areas of each map to treat as links to spaces, seats, or even other maps (i.e. clicking a container space shows a map of the seats inside). A map can correspond to an entire location, or to an individual zone within a location.

Once a map is ready to go, we'll upload it to your site. You're then ready for the next step: associating the clickable areas with your spaces & seats in LibCal.

Step 2. Configure each map's settings & associations

The maps that are added to your LibCal site will be in SVG format, with a shape outlining each space/seat. The next step is to associate each of those shapes to their corresponding space or seat in LibCal. This creates what we call a "hotspot": when a patron clicks on a hotspot from the map's public page, LibCal will present them with the details & booking link for the associated space/seat.

To get started, Admin users should navigate to LibCal's Maps settings:

  1. Click on the Admin menu and select Maps from the dropdown.
  2. Under the Maps tab, locate the map you want to set up from the Interactive Maps panel and click on its Edit () icon in the Action column.
    • You can identify each map by the Name column. As maps are set up, you'll also be able to see its Type, Location, Zone, and/or Space as appropriate.
    • Maps will not have a public URL until all of its hotspots have been associated with your spaces/seats.
a map's edit icon
To change a map's settings & associations, go to Admin > Maps. Then, under the Maps tab, click on the map's Edit icon.

General settings

Under the General tab, you can customize the map's:

  1. Name: displays as the heading on the map's public page
  2. Description: displays below the heading on the map's public page
  3. Friendly URL: lets you customize the map's direct link. (Friendly URL slugs can only contain letters, numbers, dashes, and underscores.)
  4. After making any changes, click the Save button.
a map's General settings
Under the General tab, you can customize a map's name, description, and friendly URL.

Map type

Under the Associations tab, you can configure the map's Type. There are three Map Type options:

  • Spaces Location: the map corresponds to one of your locations from Admin > Spaces & Equipment. If all of the available spaces/seats in a location are contained in a single map, this is the best option.
  • Spaces Zone: the map corresponds to a single zone in one of your locations. For example, if a location has one zone for each floor of your library, this option would let you connect one map to each zone.
  • Spaces Space: the map corresponds to a single container space. This option is best suited for seat bookings. This type of map can be associated to a space's hotspot in a zone or location map; when patrons click on the space hotspot, they will then see the space map with available seats.

If this is a newly added map, you will be prompted to do set its type before setting up associations between hotspots and spaces/seats.

  1. From the Map Type dropdown, select the option that best corresponds to the scope of your map.
  2. From the Location dropdown, select the location this map belongs to.
  3. If you selected a map type of... 
    • Spaces Zone: select the zone this map belongs to from the Zone dropdown.
    • Spaces Space: select the space this map belongs to from the Space dropdown.
  4. When finished, click the Save & Setup Associations button.
map type options
The Map Type is location, zone, or space that a map corresponds to.

If you already configured a map's type, you can change it by clicking the Change the map type link above the map's associations.

the Change the Map Type link
You can change a map's type by clicking the Change the map type link.


After the map's type has been set, the Associations tab is where you will associate each hotspot on the map to a space, seat, or other map.

the Associations and Map Preview columns
Each shape can be associated to a space, seat, or other map. Click on a Shape Name and the associated shape will highlight in the Map Preview.

For each row under Associations:

  1. Click inside the Shape Name field. In the Map Preview column, the corresponding hotspot will become highlighted. We recommend that you customize the shape name to better describe the area of the map it represents. That will make maintaining your map much easier in the future.
    • Similarly, if you click on an area of the Map Preview, the Associations column will scroll down to the corresponding shape.
  2. From the Association Type dropdown, select either MapSpace, or Seat (depending on your map's type).
    • Map: choose this option if you want that shape to link to another map. For example, if this shape corresponds to a container space, you can associate it with that space's seating map.
    • Space: choose this option if the shape corresponds to a space that is bookable as a whole. This option is available for maps with a type of either Location or Zone.
    • Seat: choose this option if the shape corresponds to a seat. This option is available for maps with the Space type.
  3. From the Associated Resource dropdown, select the MapSpace, or Seat to associate with that shape.
  4. Once you've finished setting up your associations, click the Save button.

Accessing your maps

A map's public URL becomes active once all of its hotspots have been associated to a resource (space, seat, or other map). Its link will display on the Maps page in the Public URL column.

the Public URL column on the Maps page
A map's public URL will become available once all hotspots have been associated to a space, seat, or other map. It will display in the Public URL column of the Maps page.

You can also find links to your maps by clicking on the Admin menu and selecting Spaces & Equipment. Under the Locations tab, the Map column will link to the admin page for a location map, where you can edit its settings. To view the map's public page, click on the location's Map () icon in the Action column.

When viewing a location's Zones or Spaces & Categories, you will find similar options for zone and space maps respectively

the Locations tab on the Manage Spaces & Equipment page
You can also find map links when managing your spaces & equipment. The Map column provides a link to the associated map's settings, while the map () icon will link to its public page.