Skip to main content

Title & subtitle

Add up to two lines of text at the top of the map: a bold primary title and a smaller subtitle beneath it. Both overlay the map area without shrinking it — the projection and data fills remain unchanged.

Examples​

Title and subtitle together

https://api.maproll.io/map.svg?scope=world&data=US:200,CN:150,IN:80,BR:60,RU:120&theme=dark&title=GDP%20per%20capita&subtitle=World%20Bank%202023
World choropleth with title 'GDP per capita' and subtitle 'World Bank 2023'

Title only

https://api.maproll.io/map.svg?scope=world&data=US:1&theme=light&title=Just%20a%20title
World map with title only, no subtitle row

Title, subtitle, and logo stacked

https://api.maproll.io/map.svg?scope=world&data=US:200,CN:150,DE:95&theme=dark&title=GDP%20per%20capita&subtitle=World%20Bank%202023&logo=true
World map with title, subtitle, logo, and attribution all visible

Parameters​

ParamTypeDefaultAllowedNotes
titlestring—Up to 120 charactersRendered bold, centered, near the top of the map.
subtitlestring—Up to 160 charactersRendered smaller and lighter, directly below the title. Has no visible effect if title is absent.

Notes​

  • Both parameters are optional. Omitting both produces a clean map with no text at the top.
  • subtitle without title is accepted by the API but produces no visible output — the subtitle row requires the title to establish the text block position.
  • Text is centered horizontally in all cases. Left/right alignment is not currently configurable.
  • Title and subtitle overlay the map; they do not reserve space from the projection. On dense maps with data near the top edge, the text may overlap fills. Use height to add vertical room if needed.
  • Spaces must be URL-encoded as %20 (or + in query strings). Special characters should be percent-encoded.
  • Theme-aware colors are used for the text, so the title remains legible on both light and dark backgrounds.