CARTO User Manual

CARTO User Manual

Publishing and sharing maps

This guide describes how you can share any CARTO map with your teammates, or publish a map to the internet, using CARTO Builder.

When you create a map, it’s always private by default.

To be able to share a map, you need to add data and a title to the map:

Publish options share link button

Publish options share link button

Once you have added data and a title to your map, the Share button will be enabled and you will be able to share your maps with your organization, by clicking the Share button on the top-right to open the sharing options.

Publish options share link button

A new dialog screen will open allowing you to select who you want to share your maps with:

Publish options share link

Here you’ll find three different sharing options:

  • Private: Only you can view and open it.
  • Organization: The map will be visible to all users in your organization.
  • Public Map: The map will be visible to anyone in the internet with the link.

Remember that if your map is “shared” or “public” you’ll need to push your changes with the “Publish Updates” button, next to the sharing button in the top-right menu.

Publish map refresh button

Public maps have some extra options: to share the link with the public, to get Developers information for embedding, or to work with CARTO for developers. You can toggle between these subtabs and select the option you are interested in.

Publish options share link

Publish options share link

Password protected maps

You can also protect your maps before sharing them by enabling password protection and setting a map password.

Publish options share link

Once you have set your map password, select your public map option and click on Apply.

Publish options share link

When someone opens the link, they will be asked to enter the map password before loading the map. Insert the map password and click on Continue to visualize the map or contact the owner if you need access.

Publish options share link

Publishing updates for shared and public maps

Once your map is shared or public, you can manage the state of the map for your viewers (so your editing doesn’t affect their experience). When you’re ready to push an update, click on the Publish Updates icon:

Publish map refresh button

You will see the date for the last time the map changes were pushed to the viewers. If you want to update it and push the current version, click on Publish Updates:

Publish map refresh button

Viewers will see always the version of the map that you last updated.

Embed API

CARTO embed maps can be controlled via URL parameters. These parameters allow to dynamically configure an existing map. This is specially useful when building story maps with no-code tools. Take a look at this tutorial to know more about it.

Parameter Functionality Example
lat / lng Define the coordinates where the map should be centered …?lat=48.856&lng=2.348
zoom Define the zoom level when loading the map …?zoom=15
pitch Control the vertical angle in degrees. From 0 (orthogonal to the ground) to 60 …?pitch=40
bearing Control the horizontal angle measured clockwise as an angle from 0 (North). East is 90° , south is 180°, and west is 270° …?bearing=90
layers Select the layers that are visible in the map as a list of visible layers. Starts at 0 with the first layer in the Builder map …?layers=0,1