Your search returned no results

Try another search term or view Stack Exchange, where we have active conversations with Developers about GIS.

    http://gis.stackexchange.com/
    Support channel in Stack Exchange

    Thousands of developers around the world have helped make CartoDB a success, and we have active conversations with them about GIS in Stack Exchange.

    Go to Stack Exchange

    Maps

    Map Privacy

    When you create a map with CARTO, you can protect your map and identify the privacy options as Public, With link, Password protected, or Private. These map privacy settings are managed through the map metadata and enable you to determine how your maps are accessed.

    Note: Map metadata is stored separately from your dataset metadata. This enables you to share maps while protecting each layer of data.

    The following image, and table, display the available map privacy options.

    Map privacy options

    Map Privacy Option Description
    Public Available to anyone on the internet and viewable from your public profile page on CARTO
    With link Only accessible to anyone that has the shared link to the map. This type of map is not viewable from your public profile
    Password protected Indicates that map is password protected. When selecting this option, type a password and click SAVE SETTINGS. This type of map is not viewable without the password and does not appear from your public profile
    Private A private map that is only visible to you

    You can access the map privacy options through your maps dashboard or through the Data View and Map View for a selected map.

    Note: Different privacy options may appear, depending on your account settings.

    Map Metadata

    You can edit the attributes for each map to add metadata for your map. This is useful for keeping your maps organized and discoverable in a search, as your repository of maps increases. This is especially useful if your map is public.

    Note: Map metadata is stored separately from Dataset metadata. Each dataset contains its own metadata, however, once you connect a dataset to a map, you can edit the dataset metadata as a layer within the map.

    Editing Metadata for a Map

    The following procedure describes how to edit metadata for a map.

    1. Click Your maps from your dashboard drop-down menu

      Select Your Maps from Dashboard

      The page refreshes, displaying a list of your maps.

    2. Select the name of the map to view, or click the Edit icon on a map

      Select Map

      The page refreshes, displaying the Map View for the selected map.

    3. Click Edit metadata from the selected map

      Note: You can edit metadata from the Data View or Map View of a selected map. The Data View contains the connected dataset as a layer within the map.

      Edit Metadata

      The Map metadata options appear.

    4. Edit the map name, description, and tags for the selected map. You can also change your map privacy settings

      Map Metadata

      The following map metadata options are available.

      Map Attribute Description
      Map name The name of the map. Note to be as specific as possible if this is a public map
      Description Describe the content and purpose of your map. You can also add license information in this field if you are sharing your map
      Tags Tags enable you to group your maps by project or theme
      Privacy Options may vary depending on your account settings. Click the current status to change the (privacy settings) for the selected map
    5. Click SAVE to close and save the map metadata attributes

    6. Click Search to search your repository of maps by name or tag

      Search by metadata

      Note how applying metadata enables you to identify and search for map attributes.

    Tip: You can add a description, add tags, or edit the map privacy setting directly from your maps dashboard. Once an initial map description and map tag is entered using this shortcut, you must click Edit metadata from the selected map if you need to update these attributes again.

    Edit Map Metadata from Dashboard

    Map Toolbar

    The map toolbar includes options to add map elements (such as title, text, annotation, and image items), preview the map to configure it for desktop or mobile applications, and export a static image of your map. This toolbar appears above your map, from the Map View of a selected map.

    Map Toolbar

    Add Element

    In Add Element, it is easy to add overlays on top of your map that help to better showcase your map and clarify the design. With this function you can quickly add fully customizable titles, texts, annotations, and images.

    Add Element

    • Add Title Item

      When you add this item, a text box with a title format will appear on your map. You can place the title box wherever you want and edit the style.

    • Add Text Item

      Similar to titles, text boxes will give you control over the position of a block of text on your map. You can place text boxes anywhere in your visualization and edit them.

      For annotation, title, and text box overlays, double clicking an element allows you to change the content. Clicking on the element opens the overlay customization toolbar. From here, the text size, colors, fonts, alignment, and box properties can be tailored to fit your map. The toolbar also allows for additional actions with your overlays such as bringing a layer forward or backward, duplicating a layer, or deleting an element entirely.

    Text Edit Toolbar

    • Add Annotation Item

      Annotations are text overlays linked to a coordinate and a zoom range. They allow users to explain and point to specific map elements. These overlays will remain fixed on a position on the map, and are excellent for annotating information, telling stories, or highlighting interesting information.

      Similar to the title and text overlays, clicking an annotation element brings up the customization toolbar. You will notice that a Zoom (min-max) option has been added. This allows for dynamic annotations and zoom-dependent labeling of map items.

      Add Annotation Item

    • Add Image Item

      An image can give extra value to your visualization. You will only need to add the image link to the box and it will pop up on your map. You can edit the box style color, the position, and also change the width with the customization toolbar.

    Preview Map

    Map

    We use our portable devices frequently to consume content, so there is a chance that many people will visit your maps using a mobile device. And that means a small screen in which not many elements will fit right. That’s why we let you create responsive maps: you can design your map for desktop and mobile devices. We offer two canvases so you can design your map for each type of screen.

    By default you are in Desktop view. If you switch to the Mobile view, you’ll see that we crop the viewable area. If you include elements for the Desktop view, you’ll see that they are not present when you switch to Mobile. You can create specific elements for this new view, and vice versa.

    mobile

    Export Image

    The Export Image option enables you to export a static image of a map in .PNG format. You can adjust the zoom level and the size of the map before exporting it as an image. Advanced export image options are also available, which enable you to customize the size and format of the exported static image. Once your map image is exported, you can print it and share it.

    1. From the Maps View of a selected map. click Export Image

      Your map is selected and the export image options appear.

      Export Image

    2. Adjust the zoom level of the image by using the increase size (+) or decrease (-) buttons, located to the top-left of the image

    3. Adjust the size of the image by clicking and dragging the edges of the selection.

      The width and height changes in displays in pixels. The maximum export pixels values that can be entered for the Export Image options are:

      • Maximum width in pixels (838 px)
      • Maximum hight in pixels (619 px)
    4. Click Export, located underneath the selected image

      Tip: See advanced export for a description of the advanced export image options.

      Export the Image

      A confirmation dialog appears, indicating that your image has been generated correctly.

      Export Image Confirmation

    5. Click VIEW IMAGE to view the exported .PNG image in a new tab

      Tip: Ensure that your browser pop-up blocker is disabled.

      You can also share this map image by sharing the URL to the exported image.

    Once your map image is exported, you can print it. The maximum print PPI (pixels per inch) resolution for exported images is 72ppi. For details, see Setting the Print Resolution for Exported Images.

    Advanced Export Image Options

    The advanced export image options enable you to enter a custom image size and save the image in .PNG or .JPG format.

    1. Once you select Export Image and adjust the zoom level as describe above, click advanced export, located underneath the selected image

      Advanced Export image option

      The Export custom image size dialog box appears.

    2. Enter in a custom width an height, in pixels

      Export custom image size dialog box

    3. Select the image format as either .png or .jpg

    4. Click EXPORT

    5. Click VIEW IMAGE to view the exported .PNG image in a new tab

      Tip: Ensure that your browser pop-up blocker is disabled.

    You can also share this map image by sharing the URL to the exported image, or print the exported image.

    Setting the Print Resolution for Exported Images

    The maximum print PPI (pixels per inch) resolution for exported images is 72ppi. If the quality of you exported image is not sufficient, you can export the image at a larger dimension and use an external image editor (such as Photoshop) to size down the image to your desired print dimensions.

    For example, if you are creating an 11x17 inch image for printing at 300ppi resolution, the pixel dimensions are 3300 pixels wide by 5100 pixels tall. If you are creatinge an 11x17 inch image for 72ppi resolution, the pixel dimensions are 792 pixels wide by 1224 pixels tall (Tip: For landscape format, you should apply 1224 px x 792 px dimensions). If you are using the 72ppi image in a program that prints out at 300ppi resolution, it will not fill the area of the printed page.

    If you are using the CARTO Editor, the maximum pixels values that can be entered with the export image options are:

    • Maximum width in pixels (838 px)
    • Maximum hight in pixels (619 px)

    Note: If you are using the advanced export image options (or using the MAPS API to export static map images), the following Static Maps API Limits are enforced.

    Edit Map Options

    The following options are available from the Edit menu of the Data View or Map View of a selected map.

    Map Edit Options

    Tip: These edit options are separate from the (map display options), accessible from the bottom of a selected map.

    Map Edit Menu Options Description
    Export layer A dataset appears as a layer on your map. You can export the dataset layer for use offline. This process is identical to exporting a dataset once you select Export layer from the Edit menu. For details, see how to Export Data
    Georeference layer Edit your map and apply geocoding coordinates to transform your data. This process is identical to the georeferencing dataset options once you select Georeference layer from the Edit menu. For details, see Geocoding Data
    Duplicate map Creates a duplicate of your map so that you have a backup copy of it. Note that changes applied to a duplicate map are not applied to the original
    Export map Exports a map, and connected data, as a .carto file. This is useful for downloading complete CARTO visualizations that you can share or import. For details, see Export Map
    Change privacy You can protect your map and identify the privacy setting. For details, see Map Privacy Settings
    Lock map To prevent your map from undesired changes, you can lock a map and hide it from your dashboard. For details, see the Frequently Asked Questions about how to lock a dataset or map
    Delete map Deletes the selected map

    Export Map

    The Export map option enables you to download a map, and the connected dataset, as a .carto file. This .carto file includes the dataset and visualization definition, which contains any SQL queries, CartoCSS, basemaps, attributions, metadata, and styling that was applied to a map.

    1. Open a selected map from Your maps dashboard

      The page refreshes, displaying the Map View for the selected map.

    2. Select the Export map option from the Edit drop-down menu

      The Export map confirmation appears.

      Export Map confirmation

      Tip: You can also access this option by clicking the export icon from any CARTO Public Profile map.

      Export Map from a Public Profile page

    3. Click OK, EXPORT

      The map, and connected data, is exported to your Downloads folder as a .carto file. See the rules about what is exported.

      Note: The Ready to Download dialog will appear if you do not have pop-ups enabled for Carto. Allow pop-ups from CARTO in your web browser to begin the download and export process.

    4. Additionally, you can import a .carto file with the CARTO Editor. This is useful if you are sharing maps with team members, exported a public map from someone’s CARTO’s Public Profile page, or if you are migrating maps to another account

      • From Your maps dashboard, click NEW MAP
      • Click Connect Dataset

        From the Connect Dataset options, select Data file to browse to, or drag your downloaded .carto file

      • Click CONNECT DATASET

      Your map and dataset are imported. See the Exporting/Importing .carto files section for details about what is imported.

    Note: You can also import .carto files with the Import API. For details see CARTO Map Visualizations.

    Exporting/Importing .carto files

    This section describes the behavior that is enforced when exporting and importing .carto files. It also describes how .carto files are handled with privacy settings.

    Exporting Rules:

    • When exporting, the privacy settings of your map and dataset are inherited in the .carto file. You will only be able to export what you have access to, anything else is excluded
      • For Private and Password protected maps, only the owner can export
      • For With Link and Public maps, everyone can export
      • For Enterprise users, you can export private maps that have been shared with you
    • If you have a map with multiple layers, all accessible layers of your map will be exported

    Importing Rules:

    • Where you import the .carto file matters!
      • If importing the .carto file as a NEW DATASET from Your datasets dashboard, only the data is imported
      • If importing the .carto file as a NEW MAP from Your maps dashboard, the map and dataset(s) are imported
    • You will only be able to import public data that is shared with you. If there is any private data, or private layers included in a map, those layers will be excluded from the .carto file
    • Importing .carto files containing map and datasets with the same name as existing maps and datasets:
      • If the .carto file contains a map with the same name as an existing map, a duplicate map is created
      • If the .carto file contains a dataset with the same name as an existing dataset, it will generate a new dataset with a number suffix to avoid overwriting data. For example, if my_table is an existing dataset in your account, importing a .carto file with a dataset named “my_table”, is imported as my_table_1. However, the map included as part of the .carto file will use the original dataset my_table, not my_table_1. As an alternative, you can rename the dataset to a unique name before exporting
    • When importing a .carto file, you will only be allowed to import the number of layers allowed for your account plan. For example, if someone is sharing a .carto file and has more layers enabled for their account, you will only be able to import the first four layers to your account

    CARTO Sidebar

    The CARTO sidebar enables you to access additional tools to help you customize your map data. The sidebar appears minimized by default from the Maps View. Clicking a sidebar option expands the options over your map. This section describes the options available from the CARTO sidebar.

    The CARTO sidebar appears minimized by default. When an option is selected, the sidebar expands displaying the related options. You can switch between minimizing and maximizing the sidebar options. The following example displays a side-by-side view of the sidebar option minimized and maximized.

    CARTO Sidebar

    Add Layer

    If you need to show multiple layers to differentiate hierarchies in your map, you can add layers from the CARTO sidebar from the MAP VIEW, or the DATA VIEW. The maximum number of layers per map depends on your CARTO account. All plans contain at least four layers and increase up to six layers, depending on your account type. Please contact us if you need a custom number of map layers for your account.

    When you click the Add layer plus sign from the CARTO sidebar, the Add a new layer dialog box appears.

    Add a new layer option

    You can:

    • Click Connect dataset to open view the connect dataset options, select from your existing datasets from your datasets dashboard, select from the Data library, or add an empty layer
    • Click ADD LAYER to add the layer
    • Style each layer independently

      Note: When styling a map with multiple layers, the order of the layers reflects the order in which they are visualized. You may need to adjust the styling for each layer to accommodate conflicting features. For example, suppose you have one fully opaque layer over another one, you may be unable to view the data under the opaque layer. Additionally, if you have infowindows enabled for both layers, only the top layer infowindow is displayed in areas where the bottom layer covered (by the top layer).

    For details about layers using CARTO.js, see the Create Visualization vs. Create Layer section of The Map Academy course.

    SQL

    SQL (Structured Query Language) is how applications request data from a database. The CARTO geospatial database is built on the PostgreSQL platform and supports advanced PostGIS capabilities. PostGIS allows you to perform geospatial queries, such as finding data points within a given radius, the area of polygons in your dataset, and so on.

    SQL queries enable you to:

    • Request simple queries (i.e. “request all records from this dataset”)
    • Request queries that match certain conditions (i.e. “request all records in which this field equals a certain value”)
    • Request more complex queries that combine data from two or more datasets
    • Change your map projection by inserting definitions

    The SQL option is available from the CARTO sidebar and displays when an SQL query is applied.

    SQL Query

    When you connect a dataset and create a map, all of the data in the dataset is displayed by default. You can apply an custom SQL query, or use the filters option, to view specific data.

    Tip: If you apply a filter, the related SQL code automatically appears in the custom SQL query. This enables you to view and modify what SQL queries are applied to your data. See the SQL and PostGIS in Carto Map Academy course for more details about querying your data.

    Wizards

    The CARTO map wizard is an interface that enables you to quickly style your data layers. The wizards option is accessible from the CARTO sidebar of the Map View. This section describes how to access the map wizard and includes details of the available styling options, based on your data.

    Note: The wizards options vary, depending on the type of dataset that is connected to your map.

    1. Click Your maps from your dashboard drop-down menu

      Select Your Maps from Dashboard

      The page refreshes, displaying a list of your maps.

    2. Select the name of the map to view, or click the Edit icon on a map

      Select Map

      The page refreshes, displaying the Map View for the selected map.

    3. Click wizards from the CARTO sidebar

      The sidebar expands, displaying a list of style options based on your data.

      Wizards

    4. Click a map type from the ribbon options to view the applicable styling options

      Note: The wizards options vary, depending on the type of dataset that is connected to your map. Selecting a map type displays the applicable styling options in the wizard.

      The following map types are available, depending on your data.

      Map Type Wizard Options
      Simple Displays data as simple marker or polygon points. You can set the point size, point opacity, select a marker image or polygon pattern, select the marker/polygon color, add label text, and select the composite operation effect. This map type is recommended for beginners.

      For details about all Simple styling options available from the wizard, see Simple.
      Cluster Displays point files in a group of numbered circles, rendering a cluster of points in close proximity of a given area.

      For details about all Cluster styling options available from the wizard, see Cluster.
      Choropleth A thematic map, with regions of different colors, applied in proportion to the data. This is based on a secondary numeric value from a column in your dataset.

      Tip: Choropleth is often used with polygon data to compare characteristics of regions and areas, such as income levels by neighborhood.

      For details about all Choropleth styling options available from the wizard, see Choropleth.
      Category Displays points and polygons, in different colors, based on a qualitative characteristics (categories) in your dataset.

      Tip: If your data contains multiple characteristics (i.e. land-use zones), you can use the Category wizard options to change the color of each characteristic (i.e. blue for residential, red for commercial, and purple for mixed-use districts).

      For details about all Category styling options available from the wizard, see Category.
      Bubble Scales the radius of markers, based on a numeric value (as a defined column from your dataset). Bubble maps are not supported with polygons.

      Tip: Bubble maps are useful for comparing numeric values associated with a certain point, such as the population sizes of cities.

      For details about all Bubble styling options available from the wizard, see Bubble.
      Torque Data animation of a progression of points that is based on time-series data. For example, you can display temporal data and animate a progression of points, based on a data column containing the time stamp.

      Note: The standard format of the time stamp date column is YYYY-DD-MMThh:mm:ss. However, Torque maps can also visualize data that contains the year, year/month, or year/month/day format (but only if the complete timestamp is included, i.e, 2014-01-01T00:00:00Z).

      You can only add one Torque layer in the CARTO Editor. Optionally, you can use Torque.js to add multiple layers, but this is not recommended as it effects performance.

      Note: When visualizing Torque style maps, it is required that you normalize your data to show a total count, or a range, of 0-255. For more details, see this description about statistical normalization.

      For details about all Torque styling options available from the wizard, see Torque.
      Heatmap A variation of a Torque map, that creates interactive heatmaps (or animated heatmaps) for temporal data. Areas of greater color intensity indicate a larger density of data.

      You can only add one Torque layer in the CARTO Editor. Optionally, you can use Torque.js to add multiple layers, but this is not recommended as it effects performance.

      Note: When visualizing Torque style maps, it is required that you normalize your data to show a total count, or a range, of 0-255. For more details, see this description about statistical normalization.

      For details about all Heatmap styling options available from the wizard, see Heatmap.
      Torque Cat A variation of a Torque map, that displays data points in different colors based on qualitative characteristics (categories) in your dataset. Similar to the Category map, you can style different characteristics for the Torque Cat map.

      You can only add one Torque layer in the CARTO Editor. Optionally, you can use Torque.js to add multiple layers, but this is not recommended as it effects performance.

      Note: When visualizing Torque style maps, it is required that you normalize your data to show a total count, or a range, of 0-255. For more details, see this description about statistical normalization.

      For details about all Torque Category styling options available from the wizard, see Torque Category.
      Intensity Displays the density of points (similar to a heatmap), by darkening areas (of many points) in contrast to those with fewer points.

      Tip: Intensity maps are useful when you have a dataset with a large number of points and want to stratify their occurrence. You can also apply infowindows functionality to create a more dynamic style heatmap.

      For details about all Intensity styling options available from the wizard, see Intensity.
      Density Aggregates your data in hexagons and colors them based on the amount of data contained within each unit. Areas with more data points are darker than those with fewer points.

      For details about all Density styling options available from the wizard, see Density.
    5. When you choose options from the wizard, the selected styling is automatically applied to your map

    Simple

    Displays data as simple marker or polygon points. You can set the point size, point opacity, select a marker image or polygon pattern, select the marker/polygon color, add label text, and select the composite operation effect. This map type is recommended for beginners.

    The following style options are available for Simple maps.

    Simple Wizard

    Note: Depending on your data, options appear as marker or polygon.

    Simple Wizard Options Description
    Marker Fill Contains all fill options for the point (point size, point image/pattern, point color, and point opacity).
      size - The size of the marker in a numeric value between 0-40. (Note: The size option is not applicable for polygons).
      image / pattern - Select IMG to select a marker image or polygon pattern. You can also upload your own icons and patterns from these image options.

    Item image

    Item color
      color - Select a color for the point. Click the default color to open the color palette. You can select a new color, or type a color in the hex code input field (i.e. #FF5C00).

    Select point color from wizard
      opacity - A value between 0-1.
    Marker Stroke Note: This option appears as Polygon Stroke when polygon data is detected by the map wizard.

    Edit the width of your points’ border or outline (a value between 0-40), the color (using hex codes or by selecting a color from the color palette), and the opacity (a value between 0-1).

    Select stroke color from wizard
    Composite operation Change how the colors of overlapping geometries interact with one another. You can select multiply, screen, overlay, darken, lighten, color-dodge and color-burn. See CartoCSS Composite Operations for a description of composite operation effects.
    Label Text Select the column to act as a map label (if any). Note: When a value is selected for Label Text, additional styling options appear in the wizard.
    Label Font - Select the label font, size, and color. See a list of the supported fonts available through the CARTO Editor. Additionally, see the text-face-name: 'string' property for a description of fonts that can be applied with CartoCSS syntax.
    Label Halo - Change the color and width of the outline around your text. This is helpful for increasing readability.
    Label Offset - Change how far the label text sits from the marker. Positive values display the label below the marker, negative values display the label above the marker. If set to 0, the marker appears directly under the corresponding label.
    Label Overlap - Shows or hides overlapping labels. false, does not allow labels to overlap. Overlapping labels are hidden.
    Label Placement - point (places labels on top of points), line (along multiple lines or border, repeatedly), vertex (on the vertexes of points, repeatedly), interior (the interior inside a point. The label remains in place, even if the center is outside of the geometry).

    Note: Conditional formatting is not supported for Simple maps.

    Cluster

    Displays point files in a group of numbered circles, rendering a cluster of points in close proximity of a given area.

    Cluster Wizard

    Cluster Wizard Options Description
    Buckets Define the number of buckets to display groups of data. The more buckets, the more granular the data. Fewer buckets indicates that data displays at a less granular level.
    Marker Fill Contains the fill options for the point (point color and point opacity).
      color - Select a color for the point. Click the default color to open the color palette. You can select a new color, or type a color in the hex code input field (i.e. #FD8D3C).

    Select marker fill color
      opacity - A value between 0-1.
    Marker Stroke Edit the width of your points’ border or outline (a value between 0-40), the color (using hex codes or by selecting a color from the color palette), and the opacity (a value between 0-1).

    Select stroke color from wizard
    Marker size The size of your markers, in pixels.
    Label Font Select the label font and color.
    Label Halo Label Halo - Change the color and width of the outline around your text. This is helpful for increasing readability.

    Choropleth

    A thematic map, with regions of different colors, applied in proportion to the data. This is based on a secondary numeric value from a column in your dataset.

    Tip: Choropleth is often used with polygon data to compare characteristics of regions and areas, such as income levels by neighborhood.

    Choropleth Wizard

    Note: Depending on your data, options appear as marker or polygon.

    Choropleth Wizard Options Description
    Column Select the numeric value column that you want to display.
    Buckets Define the number of buckets to display groups of data. The more buckets, the more granular the data. Fewer buckets indicates that data displays at a less granular level.
    Quantification Choose the way that data is divided into buckets. Options are: Jenks, Equal Interval, Heads/Tails, and Quantile. See GIS Data Classifications in Cartographica for more information and data quantification.
      Jenks - Increases the standard deviation between each group of data while decreasing the standard deviation within each group. In other words, it increases the similarity within a given group in conjunction with the differences from each of the other groups. The Jenks method shuffles data across each group until it detects an optimization.
      Equal interval - Calculates the range of your data, and divides the total, into equally-sized subranges for your desired number of groups.
      Heads/Tails - Creates a break-point at the mean of your data, removes all data below the break-point, and creates the next break-point from the data above the first break-point. It repeats the break process until either a single value is left above the break-point, or if it reaches the desired number of breaks.
      Quantile - Creates each group with an equal number of discrete units. The discrete units are gathered from the distinct possible values of your data.
    Color Ramp Select the color theme of your dataset. Click the color ramp to select from a set of color themes. You can also select the opacity for the color ramp (a value between 0-1).

    Wizard color ramp
    Marker Width The width of the marker.
    Marker Stroke Note: This option appears as Polygon Stroke when polygon data is detected by the map wizard.

    Edit the width of your points’ border or outline (a value between 0-40), the color (using hex codes or by selecting a color from the color palette), and the opacity (a value between 0-1).

    Select stroke color from wizard
    Composite operation Change how the colors of overlapping geometries interact with one another. You can select multiply, screen, overlay, darken, lighten, color-dodge and color-burn. See CartoCSS Composite Operations for a description of composite operation effects.
    Label Text Select the column to act as a map label (if any). Note: When a value is selected for Label Text, additional styling options appear in the wizard.
    Label Font - Select the label font, size, and color. See a list of the supported fonts available through the CARTO Editor. Additionally, see the text-face-name: 'string' property for a description of fonts that can be applied with CartoCSS syntax.
    Label Halo - Change the color and width of the outline around your text. This is helpful for increasing readability.

    Label Offset - Change how far the label text sits from the marker. Positive values display the label below the marker, negative values display the label above the marker. If set to 0, the marker appears directly under the corresponding label.

    Label Overlap - Shows or hides overlapping labels. false, does not allow labels to overlap. Overlapping labels are hidden.

    Label Placement - point (places labels on top of points), line (along multiple lines or border, repeatedly), vertex (on the vertexes of points, repeatedly), interior (the interior inside a point. The label remains in place, even if the center is outside of the geometry).

    Category

    Displays points and polygons, in different colors, based on a qualitative characteristics (categories) in your dataset.

    Tip: If your data contains multiple characteristics (i.e. land-use zones), you can use the Category wizard options to change the color of each characteristic (i.e. blue for residential, red for commercial, and purple for mixed-use districts).

    Category Wizard

    Note: Depending on your data, options appear as marker or polygon.

    Category Wizard Options Description
    Column Select the numeric value column that you want to display.
    Marker Fill Note: This option appears as Polygon Fill when polygon data is detected by the map wizard.

    Contains the fill options for the point size (a value between 0-40) and the point opacity (a value between 0-1).
    Marker Stroke Note: This option appears as Polygon Stroke when polygon data is detected by the map wizard.

    Edit the width of your points’ border or outline (a value between 0-40), the color (using hex codes or by selecting a color from the color palette), and the opacity (a value between 0-1).

    Select stroke color from wizard
    List of detected map/legend items A list of the different categories that appear on your map (and your legend items). You can add an image marker and edit the color for each category.

    Item image

    Item color

    Bubble

    Scales the radius of markers, based on a numeric value (as a defined column from your dataset). Bubble maps are not supported with polygons.

    Tip: Bubble maps are useful for comparing numeric values associated with a certain point, such as the population sizes of cities.

    Bubble Wizard

    Bubble Wizard Options Description
    Column Select the numeric value column that you want to display.
    Quantification Choose the way that data is divided into buckets. Options are: Jenks, Equal Interval, Heads/Tails, and Quantile. See GIS Data Classifications in Cartographica for more information and data quantification.
      Jenks - Increases the standard deviation between each group of data while decreasing the standard deviation within each group. In other words, it increases the similarity within a given group in conjunction with the differences from each of the other groups. The Jenks method shuffles data across each group until it detects an optimization.
      Equal interval - Calculates the range of your data, and divides the total, into equally-sized subranges for your desired number of groups.
      Heads/Tails - Creates a break-point at the mean of your data, removes all data below the break-point, and creates the next break-point from the data above the first break-point. It repeats the break process until either a single value is left above the break-point, or if it reaches the desired number of breaks.
      Quantile - Creates each group with an equal number of discrete units. The discrete units are gathered from the distinct possible values of your data.
    Radius (min-max) Set the sizes of the smallest and largest markers, or bubbles, on your map.
    Bubble fill Set the color and opacity of bubble markers.
    Bubble stroke Edit the width of your points’ border or outline (a value between 0-40), the color (using hex codes or by selecting a color from the color palette), and the opacity (a value between 0-1).
    Composite operation Change how the colors of overlapping geometries interact with one another. You can select multiply, screen, overlay, darken, lighten, color-dodge and color-burn. See CartoCSS Composite Operations for a description of composite operation effects.

    Torque

    Data animation of a progression of points that is based on time-series data. For example, you can display temporal data and animate a progression of points, based on a data column containing the time stamp.

    Note: The standard format of the time stamp date column is YYYY-DD-MMThh:mm:ss. However, Torque maps can also visualize data that contains the year, year/month, or year/month/day format (but only if the complete timestamp is included, i.e, 2014-01-01T00:00:00Z).

    You can only add one Torque layer in the CARTO Editor. Optionally, you can use Torque.js to add multiple layers, but this is not recommended as it effects performance.

    Note: When visualizing Torque style maps, it is required that you normalize your data to show a total count, or a range, of 0-255. For more details, see this description about statistical normalization.

    Torque Wizard

    Torque Wizard Options Description
    Cumulative Determines whether points remain on your map throughout the animation, or fade away.
    Time Column Select the date column to display on your map. This column must contain either date-type or numerical data (so long as it reflects the passage of time) to be used in the Torque map.

    Tip: See Supported Data Types for details about how to change the data type for columns. See the PostgreSQL documentation for general information about date and time data types.
    Marker type Sets the marker type to display as an ellipse or rectangle.
    Marker Fill Contains the fill options for the point size (a numeric value between 0-40), point color, and point opacity (a value between 0-1).
    Marker Stroke Edit the width of your points’ border or outline (a value between 0-40), the color (using hex codes or by selecting a color from the color palette), and the opacity (a value between 0-1).

    Select stroke color from wizard
    Duration (sec) Set the total number of seconds for your map visualization.
    Steps Edit the number of animation groupings. Fewer steps creates a more step-by-step or choppy data animation with more data in each “step.” A greater number of steps appears smoother. This correlates to whether your data is being displayed by day, week, month, etc.
    Blend Mode Change how layered data is blended during animation by applying composite operation effects. You can select from lighter, multiply, source-over, and xor. See CartoCSS Composite Operations for a description of composite operation effects.
    Trails Display a trail effect as your data points fade away from your map. Select a value between 0-5. 5 displays a longer trail whereas 0 does not display any trail. This appears as ‘frame-offset’ in the CartoCSS Torque syntax.
    Resolution Creates a grid of your data and aggregates data to each cell of that grid. The resolution parameter determines the width and height of each cell. Larger numbers display larger grids of data.

    Note: You can also style Torque maps with CartoCSS properties. For details about Torque specific parameters, see CartoCSS - Torque Maps.

    Heatmap

    A variation of a Torque map, that creates interactive heatmaps (or animated heatmaps) for temporal data. Areas of greater color intensity indicate a larger density of data.

    You can only add one Torque layer in the CARTO Editor. Optionally, you can use Torque.js to add multiple layers, but this is not recommended as it effects performance.

    Note: When visualizing Torque style maps, it is required that you normalize your data to show a total count, or a range, of 0-255. For more details, see this description about statistical normalization.

    Torque Heat Wizard

    Heatmap Wizard Options Description
    Marker size Choose the size of your markers.
    Opacity Sets the opacity for the heatmap, a value between 0-1.
    Animated Displays temporal data into a linear Torque animation.
    Resolution Creates a grid of your data and aggregates data to each cell of that grid. The resolution parameter determines the width and height of each cell. Larger numbers display larger grids of data.

    Note: You can also style Torque Heatmaps with CartoCSS properties. For details about Heatmap specific parameters, see CartoCSS - Torque Heatmaps.

    Torque Category

    A variation of a Torque map, that displays data points in different colors based on qualitative characteristics (categories) in your dataset. Similar to the Category map, you can style different characteristics for the Torque Cat map.

    You can only add one Torque layer in the CARTO Editor. Optionally, you can use Torque.js to add multiple layers, but this is not recommended as it effects performance.

    Note: When visualizing Torque style maps, it is required that you normalize your data to show a total count, or a range, of 0-255. For more details, see this description about statistical normalization.

    Torque Category Wizard

    Torque Cat Wizard Options Description
    Time Column Select the date column to display on your map. This column must contain either date-type or numerical data (so long as it reflects the passage of time) to be used in the Torque map.

    Tip: See Supported Data Types for details about how to change the data type for columns. See the PostgreSQL documentation for general information about date and time data types.

    Note: If you select Torque Category as the map type, ensure your SQL query is not using torque_category as a column name, to prevent unexpected behaviors.
    Marker type Sets the marker type to display as an ellipse or rectangle.
    Category Column Select the numeric value column that you want to display.
    Marker Fill Contains the fill options for the point size (a numeric value between 0-40), point color, and point opacity (a value between 0-1).
    Marker Stroke Edit the width of your points’ border or outline (a value between 0-40), the color (using hex codes or by selecting a color from the color palette), and the opacity (a value between 0-1).

    Select stroke color from wizard
    Duration (sec) Set the total number of seconds for your map visualization.
    Steps Edit the number of animation groupings. Fewer steps creates a more step-by-step or choppy data animation with more data in each “step.” A greater number of steps appears smoother. This correlates to whether your data is being displayed by day, week, month, etc.
    Blend Mode Change how layered data is blended during animation by applying composite operation effects. You can select from lighter, multiply, source-over, and xor. See CartoCSS Composite Operations for a description of composite operation effects.
    Trails Display a trail effect as your data points fade away from your map. Select a value between 0-5. 5 displays a longer trail whereas 0 does not display any trail. This appears as ‘frame-offset’ in the CartoCSS Torque syntax.
    Resolution Creates a grid of your data and aggregates data to each cell of that grid. The resolution parameter determines the width and height of each cell. Larger numbers display larger grids of data.
    List of detected map/legend items A list of the different categories that appear on your map (and your legend items). You can add an image marker and edit the color for each category.

    Item image

    Item color

    Note: You can also style Torque Category maps with CartoCSS properties. For details about Torque Category specific parameters, see CartoCSS - Torque Category Maps.

    Intensity

    Displays the density of points (similar to a heatmap), by darkening areas (of many points) in contrast to those with fewer points.

    Tip: Intensity maps are useful when you have a dataset with a large number of points and want to stratify their occurrence. You can also apply infowindows functionality to create a more dynamic style heatmap.

    Intensity Wizard

    Intensity Wizard Options Description
    Marker Fill Contains the fill options for the point size (a numeric value between 0-40), point color, and point opacity (a value between 0-1).
    Marker Stroke Edit the width of your points’ border or outline (a value between 0-40), the color (using hex codes or by selecting a color from the color palette), and the opacity (a value between 0-1).

    Select stroke color from wizard

    Density

    Aggregates your data in hexagons and colors them based on the amount of data contained within each unit. Areas with more data points are darker than those with fewer points.

    Density Wizard

    Tip: When Density is selected as the map type, infowindow options are disabled. If you need to apply infowindows functionality, select Intensity as the map type instead.

    Density Wizard Options Description
    Method Displays density with either the hexagon or rectangle shape.
    Buckets Define the number of buckets to display groups of data. The more buckets, the more granular the data. Fewer buckets indicates that data displays at a less granular level.
    Color ramp Select the color theme of your dataset. Click the color ramp to select from a set of color themes. You can also select the opacity for the color ramp (a value between 0-1).

    Wizard color ramp
    Polygon Stroke Edit the width of your points’ border or outline (a value between 0-40), the color (using hex codes or by selecting a color from the color palette), and the opacity (a value between 0-1).

    Select polygon stroke color
    Polygon size Adjust the size of the polygons on your map.
    Composite operation Change how the colors of overlapping geometries interact with one another. You can select multiply, screen, overlay, darken, lighten, color-dodge and color-burn. See CartoCSS Composite Operations for a description of composite operation effects.

    Infowindows

    Infowindows provide additional interactivity for your published map. A pop-up information window appears when a viewer clicks, or hovers their mouse over, select data on your map. You can define whether the infowindow appears with the click or hover action, choose what data appears in the infowindow, style the infowindow color and width, display the default title of the infowindow, or add custom title labels for the infowindow data.

    You can create custom infowindows with HTML code directly from the CARTO Editor. Infowindows is available from the CARTO sidebar of the Map View. (For details about how to create infowindows with Carto.js, see How can I use Carto.js to create and style infowindows?).

    1. From the Map View of a selected map, click infowindows from the CARTO sidebar

      Note: infowindows are not supported for every map type. Depending on the map type selected from the wizard, the infowindow option may be disabled.

      The sidebar expands, displaying the infowindows options.

      Infowindows

    2. You can add infowindows for Click actions or for Hover actions

      Tip: Click between the subtabs to style either the click infowindow or the hover infowinodow.

      Infowindow Options Description
      style The drop-down list displays infowindow style options.

      Infowindows style drop-down list

      Tip: You can apply a custom image header to an infowindow. For details, see How to add my own images to infowindows?

      Additionally, you can embed a video in your infowindow.
      width The width field enables you to change the size of the infowindow, in pixels.
      Enable data points Each of the data points on the map is listed, you can enable the data point to appear with the slider button
      Change the order of labels You can change the order of the labels that appear. Left-click and drag a data label up or down in the infowindow options

      change the order of the infowindow data points
      Hide the label title When a data point is enabled, and the title checkbox is selected, the default title of the data point appears in the infowindow. You can deselect the title checkbox to hide the title from the infowindow. The data point value still appears when clicked (or hovered).
      Change title label To create custom labels for infowindow data points, click Change title labels from the infowindow toolbar and type in your own label name. Click Toggle fields and titles to return to the original view.

      change title label in infowindow
      Change HTML If you want to create your own custom infowindow, click Change HTML from the infowindow toolbar. Apply custom HTML code to create and style your own infowindow.

      Infowindow Change HTML

      There is a tip icon next the width field when Change HTML is selected from infowindows.

      Infowindow Change HTML tip icon

      Click to view additional guidelines and examples for creating HTML infowindows.

      Templating infowindows dialog
    3. Click Publish to view your map and click (or hover) over points to view the infowindow

      Infowindow on click

    Tip: If you receive an error message while trying to view an infowindow, ensure that you have the correct connection setup. For details, see Why is my infowindow showing an error?

    See all the Frequently Asked Questions related to infowindows.

    CartoCSS

    CartoCSS is the syntax language that enables you to customize the style of your map data. You can apply CartoCSS styles directly from the the Map View of the CARTO Editor. For more details about CartoCSS, see CartoCSS.

    Apply CartoCSS with the CartoCSS Editor

    The CartoCSS option is available from the CARTO sidebar, and opens the CartoCSS Editor. The CartoCSS Editor enables you to apply CartoCSS styling directly from the selected map view.

    1. Click Your maps from your dashboard drop-down menu

      Select your maps from your dashboard

      The page refreshes, displaying a list of your maps.

    2. Select the name of the map to view, or click the Edit icon on a map

      The page refreshes, displaying the Map View for the selected map.

    3. Select CartoCSS from the CARTO Sidebar

      Note: This CartoCSS option may be disabled, based on your data.

      CartoCSS from CARTO Editor

      The sidebar expands, displaying the CartoCSS Editor.

    4. Enter CartoCSS properties for styling your map

      Note: See CartoCSS Properties for a description of the available CartoCSS properties and values.

    5. Click Apply style

      CartoCSS Editor

      You are notified if there are any errors in the CartoCSS code. You can also click the undo and redo arrow buttons after entering code changes in the CartoCSS Editor.

      Undo Redo CartoCSS Editor buttons

    The map refreshes, displaying the CartoCSS styling changes that you applied.

    Note: While you can apply CartoCSS styles to different layers on a map, it is highly recommended that you view the suggested best practices for applying CartoCSS syntax more effectively.

    Legends

    You can add and style a map legend for a published map. Map legends can be symbols and text that describe your map data. You can add a legend title, apply label text for the legend and define how the label text appears. You can also customize the color of your legend elements. Each map type has a default legend template that you can apply and personalize. Additionally, you can create custom legends with HTML code directly from the CARTO Editor. Legends is available from the CARTO sidebar of the Map View.

    1. From the Map View of a selected map, click legends from the CARTO sidebar

      The sidebar expands, displaying the legend template options.

      Legends

    2. Select a template from the drop-down list to enable your legend options

      Legend Template drop-down list

      • Click none to disable the legend for the map layer
      • Click custom to apply your own custom legend
      • Click the legend template name based on your map type

      Note: The available legend templates are dependent on the map type. When you select a map type from the wizard, the corresponding template name is automatically applied in the legend section.

    3. Select and style your legend options

      Legend options vary, depending on your map type. The following side-by-side example shows the intensity legend template options, and the custom legend template options.

      Legend Template selected

      The following legend options may appear.

      Legend Options Description
      Template Displays the template for the legend. The available legend template is based on your map type. Select custom to create your own legend.

      Tip: To disable a legend for a map layer, select none as the legend template.
      Title Add a custom title for your legend, and show or hide the title._
      Left Label Show the label text to the left of your legend. You can also edit the left label name.
      Right Label Show the label text to the right of your legend. You can also edit the right label name.

      Tip: Other legend labels may appear depending on your map type. You can customize the legend labels for each element.

      Edit legend label text
      Colors Set the colors of the individual items in your legend. You can also synchronize with your map marker colors, when applicable. (Depending on your template, color options may vary).

      Legend color selector

      Tip: For some legend elements, you can also apply an image. Select IMG to select a symbol. You can also upload your own icons from this image option.
      Change HTML If you want to create your own custom legend, click Change HTML from the legends toolbar. Apply custom HTML code to create and style your own legend.

      Note: Select custom from the Template drop-down list to apply HTML code to a custom template. While you can change the HTML code for an existing template, we recommend that you create a custom template if you are going to change the HTML code.

      Legent Change HTML

      Click Toggle fields and titles to return to the original legends view.

      Legent Toggle fields and titles
    4. Click Publish to view your legend on your map

      Example Legend on a published map

      Tip: To view other example maps, see the CARTO Gallery page.

    Filters

    When you connect a dataset and create a map, all of the data in the dataset is displayed by default. You can use the filters option to view specific data, or specify a range of data to include or exclude. The filters option is available from the CARTO sidebar from the Data View and Map View, for both maps and datasets.

    Note: If you apply a filter, the related SQL code automatically appears in the custom SQL query. This enables you to view and modify what SQL queries are applied to your data. See the SQL and PostGIS in CARTO Map Academy course for more details about querying your data.

    1. From the Data View (or Map View), in CARTO, click filters from the CARTO sidebar

      The sidebar expands, enabling you to start filtering your data.

      Filters

    2. Select a column to filter to your data

      A list of columns from your dataset appears in the drop-down list.

      Tip: The lettered box next to the column name indicates the type of value for the data. For example, N are number values, S are string values, and D are date values. See Supported Data Types for more information.

      Select column drop-down list

      Optionally, if you are in the Data View, you can use the column context menu to filter by the selected column.

      Data View_filter by this column

    3. Include or exclude a specified range of results, as part of the filtered data

      • For numerical data, select a range to include in your map. Left-click the slider button and drag the edges to change the range of data

       Select a range of data

      • For string (or text) data, enter a value to include or exclude, as part of the filtered data

       Filter by search value

      Your data refreshed as filters are applied.

    You can apply multiple filters to your data and create a new dataset from your query, or clear your filtered data. When you apply filters to published map, the filters are included in the map output. The following example displays multiple filters applied to a dataset. Multiple filters applied

    Add Feature

    Typically, you add rows and columns to your dataset from the Data View. The Add feature option, available from the CARTO sidebar, enables you to add points. lines, or polygons directly on your map and add new coordinates to your dataset. As opposed to importing data, you can add points (lines, polygons) as you visualize features on the map.

    1. From the Map View of a selected map, click Add feature from the CARTO sidebar

      Note: The sidebar does not expand. The add feature action appears on your map.

      Add feature from CARTO sidebar

      Tip: If you are starting from an empty dataset, a dialog appears, indicating that you can add points, lines, or polygons.

      Add feature dialog

    2. On your map, click where you would like to add the point, line, or polygon coordinates

      Add feature polygon

    3. Click done to add the coordinates

      Your map updates, displaying the added coordinates.

    4. Edit details of the coordinate. You can click Select fields to open the infowindow options. The other edit feature icons enable you to edit the metadata, edit the geometry, or delete the feature.

      Add feature edit coordinates

      Tip: The number that appears for the added feature displays the corresponding row in the dataset. You can also edit the details for the added coordinates directly from the Data View.

      Add feature edit coordinates from Data View


    Basemaps

    A basemap is a graphical representation of the world showing natural and cultural features such as water bodies, topography, park areas, points of interest, geopolitical borders, roads, streets, and sometimes buildings. CARTO provides you with a selection of basemap options and providers (such as Stamen or Here). You may import your own custom basemap (from Mapbox, an XYZ tileset (e.g. Stamen maps), or WMS.) or use a solid background color, repeating image, or pattern. With the easy-to-use basemap selector, you can focus on an aesthetically pleasing way of visualizing your data.

    Changing your Basemap

    The default basemap for the Here layer of a map is Nokia Day. The Change basemap options enable you to change your basemap and style.

    • You can link to an external URL basemap with the Yours option. Click the + to open the Add a custom basemap options, enabling you to select from different resources
    • You can also add a custom solid color with the Custom option. Click to change the map background color
    • Optionally, you can select a repeating image pattern, instead of a basemap with the Custom IMG option. This opens the Select a pattern image dialog box. Additionaly, you can upload other files as your tile background with these options.

    The Change basemap options are applied immediately and do not alter any other layers in your map.

    Change Basemap

    Note: The provided basemaps are not editable, you cannot customize features from these preset basemap options. You can, however, create your own custom basemap by adding data to your map, or importing your own custom basemap.

    Including an External Basemap

    Apart from the default basemaps offered in Carto, you may integrate third-party basemaps to customize your maps even further. The following procedure describes how to add a custom basemap from an external resource.

    1. Click Change basemap, located on the bottom left of a selected map

    2. Expand Yours to add an external resource

      Add your own NASA basemap

      The following image, and table, display the available external resources to choose from.

      Add custom basemap option

      External Basemap Resource Description
      XYZ XYZ Templates enable you to access many other basemaps, including those from OpenStreetMap and Stamen. Insert the basemap URLs and click ADD BASEMAP. For example:

      Stamen Toner:
      http://{s}.stamen.com/toner/{z}/{x}/{y}.jpg

      Stamen Terrain:
      http://{s}.stamen.com/terrain/{z}/{x}/{y}.jpg

      Stamen Watercolor: http://tile.stamen.com/watercolor/{z}/{x}/{y}.jpg

      OSM:
      http://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png
      WMS/WMTS A WMS, or Web Map Service, enables you to connect to online generated map images by a map server using data from a GIS database. Insert your WMS/WMTS URL and click GET LAYERS. For example, WMS baselayer.

      Note: Currently, CARTO only supports WMS files containing data that uses EPSG:900913 (Web Mercator) or EPSG:3857 coordinates.
      NASA Enables you to select a basemap provided by NASA Worldview. Select a date from which you want a global basemap and indicate Day (a day map changes based on the day selected) or Night
      Mapbox Mapbox is a service which lets you customize the design of a basemap with custom colors and elements. Insert your Mapbox URL and access token to add the basemap

      Note: CARTO only supports Mapbox classic urls. If you enter a new Mapbox Studio url, an error appears.
      TileJSON Enables you to insert an open platform, web map by inserting the TileJSON URL. A TileJSON map contains tiles, minzoom and maxzoom as mandatory fields
    3. The map refreshes, displaying the external resource as a basemap layer.

    See the Frequently Asked Questions related to Basemaps.

    About Map Projections

    We all know by now that the earth is not flat. Maps, however, are. As 2D representations of the globe, maps are inevitably distorted. The methods used to digitally render the earth are called map projections. Different types of projections are used to represent the earth at various scales. From the continents to a single region or state / province, each projection type must preserve certain spherical properties at the expense of others (such as area, direction, shape, and distance).

    The majority of online maps are a variant of the Mercator Projection, commonly referred to as the Web Mercator. By default, maps created in CARTO use the Web Mercator projection. You can learn more about map projections on Wikipedia.

    Note: Alternatively, you can create non-Mercator maps by applying an SQL query to your maps. This enables you to change the default map projections in your dataset by inserting a projection definition. For examples of how to create non-Mercator maps, see the Free Your Maps from Web Mercator blogpost.

    Displaying Map Options

    In addition to changing your basemap, you can also control which options are visible on your map by using the Options selector. Click the slider button to display the selected option as visible or hidden on the map.

    Map display options

    Tip: Some options are only active when viewing your map from your public profile page, not from the preview map of your dashboard.

    Map Option Description
    Fixed tile Displays your map title on the map
    Fixed description Displays your map description on the map
    Search box Displays a search box on the map, enabling you to search for data points
    Share options Displays an icon for sharing your map. You can share your maps on social media, get a link to the map, or embed it using HTML code. For details, see (Sharing Maps)
    Scroll wheel zoom Displays the ability to zoom with the scroll wheel of your mouse
    Layer selector Enables you to display the visible layers on the map
    Legends Displays any map legends. For details about how to create legends, see (Legends)
    Fullscreen Enables you to view the map in fullscreen mode
    CARTO Logo Enables you to include or hide the CARTO logo on your map

    Note: Based on your (account settings), this option may not be enabled.

    Publish and Share your Map

    This section contains information about publishing your map, sharing your map, and the attribution requirements that you must include.

    Publishing Maps

    Once you visualize and publish a map, you can get a link to share the map, embed it to a website or blog, or add your map to another application. The Publish button is available from the Data View or Map View of your dashboard when a map is selected, and displays the following options.

    Publish button

    How do I embed a map in my site/blog

    Note: You cannot publish a private map.

    • Get the link

      Provides a URL to the map as it appears in your CARTO public profile.

      1. Select the URL from the Get the link field
      2. Copy and paste the link anywhere (email, social media, blog posts) to share the link
    • Embed it

      Provides HTML code to embed the map.

      1. Select the embed code from the Embed it input field
      2. Click Go to your map to view how the embedded map appears and customize any of your iframe parameters as needed

      Tip: This is very useful for publishing interactive maps of your data on your website or blog. For example, you can insert CARTO maps by including the iframe in the HTML code editor of WordPress, Joomla, and Drupal. Additionally, you can embed an iframe with the Embedly API.

    • CARTO.js

      Provides a URL to your viz.json file, which is required if you are using the CARTO JavaScript library CARTO.js to publish maps in an external application.

      1. Select the URL from the “CARTO.js” input field
      2. Copy and paste the link to your external application

      Tip: For details about CARTO.js, view the related documentation.

    Sharing Maps

    You can enable the Share options icon to display on a published map. When your map is viewed from your public profile page, clicking the share icon enables you to share you map on social, media, get a link to the map, or embed it using HTML code.

    • Select Share options from the Options selector on a map. For more information about the Options selector, see Displaying Map Options

    The following image displays an example of the share icon, and available options, from a public map.

    Share options

    Attribution Requirements for Publishing and Sharing Maps

    Regardless of your CARTO account plan, you must include proper attributions whenever you publish or share your map. Attributions represent the data sources used in your map, which may have copyright protections.

    There are several methods of defining map attributions.

    Attribution Method Requirement
    Automatic Attributions When you choose a basemap with the CARTO Editor, map attributions are automatically included.

    When you export an image, or export a map, with the CARTO Editor, map attributions are automatically included.

    When you use CARTO.js to create a map, map attributions are automatically included.

    Note: Do not remove any automatic attributions.
    Dataset Attributions When you are using third-party data for your maps, you may need to provide attributions about the data sources. To add attributions to a dataset, Edit the Dataset Metadata.
    Print Attributions When you are printing CARTO maps, be sure map attributions are included. For details, see How to print maps in CARTO?

    Tip: For more information about how CARTO defines map attributions, see Attributions.

    Supported Fonts

    The following fonts can be selected from the map wizard, “Label Font” field, when label text is enabled for select map types: DejaVu Sans Book, unifont Medium, Open Sans Regular, Lato, Graduate, Gravitas One, Old Standard.

    Additionally, you can apply the text-face-name: 'string' property with CartoCSS syntax. These are the font families and the supported weights for each font family.

    • Open Sans
      Light, Regular, Semibold, Bold, Extrabold, Light Italic, Italic, Semibold Italic, Bold Italic, Extrabold Italic

    • DejaVu Sans
      ExtraLight, Book, Oblique, Bold, Bold Oblique, Condensed, Condensed Oblique, Condensed Bold, Condensed Bold Oblique

    • DejaVu Serif
      Book, Italic, Bold, Bold Italic, Condensed, Condensed Italic, Condensed Bold, Condensed Bold Italic

    • Lato
      Hairline, Hairline Italic, Light, Light Italic, Regular, Italic, Bold, Bold Italic, Black, Black Italic

    • Graduate
      Regular

    • Gravitas One
      Regular

    • Old Standard TT
      Regular, Italic, Bold

    • unifont
      Medium