One script tag. A living map on your site.

Drop any public Cartaveo collection into a page you already run. It arrives as a real interactive map with every place, photo and field the collection has, and it stays current as the collection grows. Match it to your colours, let visitors add places if you want them to.

No account, no API key, no build step. Paste the tag where you want the map and you're done.

Paste it where the map goes

<script src="https://cartaveo.com/embed.js" data-dataset="your-collection-slug"></script>

The underlined slug is the one thing to change. It's whatever follows /collections/ in the collection's address on Cartaveo. The tag replaces itself with the map, 500 pixels tall and as wide as whatever contains it.

It works anywhere HTML goes: a static site, a page builder's embed block, a Squarespace or Webflow code element, a Ghost post. Running WordPress? The plugin does this as a block and prints a crawlable list of places under the map.

Make it yours

Five settings, all optional. Change one and the widget on the right reloads with it; the tag underneath is ready to copy.

Theme

White surface, ink text. The default.

Basemap

Pale grey, or slate under a dark theme. Lets the pins carry the colour. The default.

Links, the active pin and the focus ring. Leave it empty for Cartaveo's green.

Pixels, 200 to 1200.

For the widget's own buttons.

The widget appears here once a collection loads.

Your tag

<script src="https://cartaveo.com/embed.js" data-dataset="your-collection-slug"></script>

Settings at their default are left out, so a plain map is still one short line. Swap the underlined slug for the collection you want.

What your visitors get

  • The whole collection, live

    Every location the collection has right now, with its photos and the fields its owner defined. A place added on Cartaveo this morning is on your page this morning.

  • A place sheet, not a popup

    Tapping a pin opens the location in a sheet inside the map: photos, description, category and the collection's own fields. Nothing leaves your page.

  • Add a place, if you allow it

    On collections that accept open contribution the widget carries an "Add a place" door. A visitor submits with a quick captcha check, and it waits in your moderation queue until you say yes.

  • Your site's dark mode

    Set the theme to match the reader and the widget follows each visitor's own dark-mode setting, the same media query your site most likely uses.

Embedding your own collection

The map on your site and the collection on Cartaveo are one thing. Add a location on either, approve a submission, fix a photo, and every page carrying the tag shows the change on its next load. Your site's visitors and Cartaveo's readers are looking at the same map.

Once your site has loaded the widget, it turns up under "Embedded on" in your collection's settings. Confirm it there and your site is named on the public collection page, which sends Cartaveo's readers your way.

Good to know

Want the data instead of the map? The read API serves the same places as JSON or GeoJSON, for drawing your own.

Nothing to embed yet? Start the collection.

A collection works from its first entry: a page on Cartaveo, a map to share, and a tag for any site you run. Make the map, then put it everywhere.