CARTO Documentation

Welcome: Welcome to the CARTO Documentation Center! All of the resources you need to unlock the power of the platform.
What's new: Learn about the latest features, improvements and bug fixes in our product.
Q2 2026: New features and improvements introduced from April to June 2026
Q1 2026: New features and improvements introduced from January to March 2026
Q4 2025: New features and improvements introduced from October to December 2025
Q3 2025: New features and improvements introduced from July to September 2025
Q2 2025: New features and improvements introduced from April to June 2025
Q1 2025: New features and improvements introduced from January to March 2025
Q4 2024: New features and improvements introduced from October to December 2024
Q3 2024: New features and improvements introduced from July to September 2024
Q2 2024: New features and improvements introduced from April to June 2024
Q1 2024: New features and improvements introduced from January to March 2024
Q4 2023: New features and improvements introduced from October to December 2023
Q3 2023: New features and improvements introduced from July to September 2023
Q2 2023: New features and improvements introduced from April to June 2023
Q1 2023: New features and improvements introduced from January to March 2023
Q4 2022: New features and improvements introduced from October to December 2022
Q3 2022: New features and improvements introduced from July to September 2022
FAQs: Frequently Asked Questions about the CARTO platform and its components.
Accounts
Migration to the new platform
User & organization setup
General
Builder
Workflows
Data Observatory
Analytics Toolbox
Development Tools
Deployment Options
CARTO Basemaps
CARTO for Education
Support Packages
Security and Compliance
What is CARTO?
Quickstart guides
Connecting to your data
Creating your first map
Creating your first workflow
Developing your first application
Overview
CARTO CLI
Installation
Authentication & profiles
Configuration
Command reference
auth
credentials
maps
workflows
projects
connections
named-sources
do (Data Observatory)
import
export
transfer
sql
org
users
activity
admin
ai
Examples
Release notes
CARTO MCP Server
Connecting with OAuth
Connecting with API Access Tokens
MCP Tools Reference
Platform tools
Interactive tools
Workflows tools
CARTO Agent Skills
Installation
Skills catalog
Overview
Creating your CARTO organization
CARTO Cloud Regions
CARTO Workspace overview: Learn everything you need to know about your Workspace and how to make the most out of it.
Maps
Data sources
Simple features
Spatial Indexes
Pre-generated tilesets
Rasters
Defining source spatial data
Managing data freshness
Changing data source location
Table and column capitalization
Layers
Point
Grid point aggregation
H3 point aggregation
Heatmap point aggregation
Cluster point aggregation
Polygon
Line
Grid
H3
Raster
Zoom to layer
Widgets
Formula widget
Category widget
Pie widget
Histogram widget
Range widget
Time Series widget
Table widget
SQL Parameters
Date parameter
Text parameter
Numeric parameter
Publishing SQL parameters
Interactions
Legend
Basemaps
Basemap selector
SQL analyses
Map view modes
Map description
Feature selection tool
Search locations
Measure distances
Exporting data
Download PDF reports
Managing maps
Version history
Sharing and collaboration
Editor collaboration
Map preview for editors
Map settings for viewers
Comments
Embedding maps
URL parameters
Performance considerations
AI Agents
Creating your Agent
Agent Config Assistant
Understanding Agent behavior
Choosing the right model
Defining your Agent logic
Working with tools
Configuring capabilities
Iterate and refine your Agent
Sharing your Agent
AI Tools Reference
Workflows
Workflow canvas
Version history
Results panel
Components
Aggregation
Control
Custom
Data Enrichment
Data Preparation
Generative AI
Input / Output
Joins
Parsers
Raster Operations
Spatial Accessors
Spatial Analysis
Spatial Constructors
Spatial Indexes
Spatial Operations
Statistics
Tileset Creation
BigQuery ML: Extension Package provided by CARTO
Snowflake ML: Extension Package provided by CARTO
Snowflake OpenRouteService: Extension Package provided by CARTO
Google Earth Engine: Extension Package provided by CARTO
Google Environment APIs: Extension Package provided by CARTO
Geospatial Foundation Models
Telco Signal Propagation Models: Extension Package provided by CARTO
Territory Planning
Analytics on Embeddings
LGND Embeddings: Extension Package provided by CARTO
Trajectory Analysis: Extension Package provided by CARTO
Data Sources
Scheduling workflows
Sharing and collaboration
Viewer Mode
Using variables in workflows
Executing workflows via API
Workflows as MCP Tools
Temporary data in Workflows
Extension Packages: Private Preview
Managing workflows
Workflows best practices
Data Explorer
Creating a map from your data
Importing data
Importing rasters with raster-loader
Geocoding data
Optimizing your data
Data Observatory
Terminology
Browsing the Spatial Data Catalog
Subscribing to public and premium datasets
Accessing free data samples
Accessing your subscriptions from your data warehouse
Access data in BigQuery
Access data in Snowflake
Access data in Databricks
Access data in Redshift
Access data in PostgreSQL
Connections
Google BigQuery
Snowflake
Databricks
Oracle
Amazon Redshift
PostgreSQL
CARTO Data Warehouse
Sharing connections
Deleting connections
Required permissions
IP whitelisting
Customer data responsibilities
Auditing SQL queries from CARTO
Applications
Settings
Understanding your organization quotas
Managing quotas
Organization Governance
Activity Data
Activity Data Reference
Activity Data Examples
Activity Data Changelog
Authentication & SSO
Users and Groups
Inviting users to your organization
Managing user roles
Deleting users
Groups
Mapping groups to user roles
CARTO Support Access
Customizations
Customizing appearance and branding
Configuring custom color palettes
Configuring your organization basemaps
CARTO AI
CARTO AI Analytics
Advanced Settings
Managing applications
Configuring S3 Bucket for Redshift Imports
Configuring OAuth connections to Snowflake
Configuring OAuth U2M connections to Databricks
Configuring S3 Bucket integration for RDS for PostgreSQL Exports in Builder
Configuring Workload Identity Federation for BigQuery
Data Observatory
Deleting your organization
Developers
Managing Credentials
API Base URL
API Access Tokens
SPA OAuth Clients
M2M OAuth Clients
Named Sources
Analytics Toolbox Overview
Analytics Toolbox Gateway
Analytics Toolbox for BigQuery
Getting access
Projects maintained by CARTO in different BigQuery regions
Manual installation in your own project
Installation in a Google Cloud VPC
Core module
Key concepts
Tilesets
Spatial indexes
SQL Reference
accessors
clustering
constructors
cpg
data
http_request
import
geohash
h3
lds
measurements
placekey
processing
quadbin
random
raster
retail
routing: BETA
s2
statistics
telco
tiler
transformations
Guides
Running queries from Builder
Working with Raster data
Release notes
About Analytics Toolbox regions
Analytics Toolbox for Snowflake
Getting access
Native App from Snowflake's Marketplace
Manual installation
Key concepts
Spatial indexes
Tilesets
SQL Reference
accessors
clustering
constructors
data
http_request
import
h3
lds
measurements
placekey
processing
quadbin
random
raster
retail
s2
statistics
tiler
transformations
Guides
Running queries from Builder
Working with Raster data
Release Notes
Analytics Toolbox for Databricks
Getting access
SQL Warehouse
Installation in an Azure VNet
Installation on a private AKS
Legacy (Deprecated)
Personal cluster
Shared cluster
Key concepts
Spatial Indexes
Reference
data
lds
quadbin
statistics
Legacy (Deprecated)
lds
tiler
Release Notes
Analytics Toolbox for Redshift
Getting access
Manual installation in your database
Installation in an Amazon Web Services VPC
Core version
Key concepts
Tilesets
Spatial indexes
SQL Reference
clustering
constructors
data
http_request
import
lds
placekey
processing
quadbin
random
s2
statistics
tiler
transformations
Guides
Running queries from Builder
Release Notes
Analytics Toolbox for PostgreSQL
Getting access
Manual installation
Core version
Key concepts
Tilesets
Spatial Indexes
SQL Reference
h3
quadbin
tiler
Guides
Creating spatial index tilesets
Running queries from Builder
Release Notes
Analytics Toolbox for Oracle
Getting access
Manual installation
Key concepts
Spatial Indexes
SQL Reference
data
h3
quadbin
Release Notes
CARTO + Python
Installation
Authentication Methods
Visualizing Data
Working with Data
How to work with your data in the CARTO Data Warehouse
How to access your Data Observatory subscriptions
How to access CARTO's Analytics Toolbox for BigQuery and create visualizations via Python notebooks
How to access CARTO’s Analytics Toolbox for Snowflake and create visualizations via Python notebooks
How to visualize data from Databricks
Reference
CARTO QGIS Plugin
Overview
Key concepts
Architecture
Libraries and APIs: The set of tools you will use to develop custom applications with CARTO
Authentication methods
API Access Tokens
OAuth Access Tokens
OAuth Clients
Connections
Data sources
Visualization with deck.gl
Basemaps: CARTO is basemap-agnostic and is compatible with MapLibre, Google Maps, Amazon Location and Mapbox GL.
CARTO Basemap
Google Maps
Examples
Gallery
Getting Started
Basic Examples
Hello World
BigQuery Tileset Layer
Data Observatory Tileset Layer
Advanced Examples
Arc Layer
Extrusion
Trips Layer
What's New
Amazon Location
Examples
Hello World
CartoLayer
What's New
Charts and widgets
Filtering and interactivity
AI-powered map interaction
Integrating Builder maps in your application
Summary
Quickstart
Make your first API call
Visualize your first dataset
Create your first widget
Guides
Build a public application: Create a basic web application in CARTO compatible with any Javascript Framework
Build a private application: How to build a basic private application with CARTO login
Build a private application using SSO: Use your company's identity management system to seamlessly control access to your application
Visualize massive datasets: Learn how to visualize massive datasets in a performance and cost-effective way (up to billions of rows)
Integrate CARTO in your existing application: Learn how to securely embed CARTO into your existing architecture providing fine-grained data access
Use Boundaries in your application
Avoid exposing SQL queries with Named Sources: Maintain a lightweight, modern and efficient architecture while avoiding the exposure of SQL queries in your application
Managing cache in your CARTO applications
Build an AI-powered map application: Add natural language map interaction to your CARTO + deck.gl application using AI-powered tool calling
Reference
Data Sources
vectorTableSource
vectorQuerySource
vectorTilesetSource
h3TableSource
h3QuerySource
h3TilesetSource
quadbinTableSource
quadbinQuerySource
quadbinTilesetSource
rasterSource
boundaryTableSource
boundaryQuerySource
Widgets
Data Sources
Server-side vs. client-side
Models
getFormula
getCategories
getHistogram
getRange
getScatter
getTimeSeries
getTable
Filters
Column filters
Spatial filters
fetchMap
@carto/agentic-deckgl
Release Notes
Examples
CARTO for React
Guides
Getting Started
Views
Data Sources
Layers
Widgets
Authentication and Authorization
Basemaps
Look and Feel
Query Parameters
Code Generator
Sample Applications
Deployment
Upgrade Guide
Examples
Library Reference
Introduction
API
Auth
Basemaps
Core
Redux
UI
Widgets
Release Notes
Overview
Key concepts
Architecture
Deployment requirements
Quickstarts
Single VM deployment (Kots): Deploy CARTO Self-hosted using a Virtual Machine, k0s, and Kots
Orchestrated container deployment (Kots): Deploy CARTO Self-hosted using Kubernetes and Kots
Advanced Orchestrated container deployment (Helm): Deploy CARTO Self-hosted using Kubernetes and Helm
Guides
Guides (Kots)
Configure CARTO AI Prerequisites (Kots)
Configure your own buckets: For CARTO Self-hosted using Kots
Configure an external in-memory cache: For CARTO Self-hosted using Kots
Enable Google Basemaps: For CARTO Self-hosted using Kots
Enable the CARTO Data Warehouse: For CARTO Self-hosted using Kots
Configure an external proxy: For CARTO Self-hosted using Kots
Enable BigQuery OAuth connections: For CARTO Self-hosted using Kots
Configure Single Sign-On (SSO): For CARTO Self-hosted using Kots
Use Workload Identity in GCP: For CARTO Self-hosted using Kots
High availability configuration for CARTO Self-hosted: For CARTO Self-hosted using Kots
Configure your custom service account: For CARTO Self-hosted using Kots
Tracking Activity Data from Public Maps (Kots)
Guides (Helm): Guides for CARTO Self-hosted using Kubernetes and Helm
Configure CARTO AI Prerequisites (Helm): In this post you'll find all you need to do to enable the AI Features in Self-Hosted using Helm.
Configure your own buckets (Helm): For CARTO Self-hosted using Kubernetes and Helm
Configure an external in-memory cache (Helm): For CARTO Self-hosted using Kubernetes and Helm
Enable Google Basemaps (Helm): For CARTO Self-hosted using Kubernetes and Helm
Enable the CARTO Data Warehouse (Helm): For CARTO Self-hosted using Kubernetes and Helm
Configure an external proxy (Helm): For CARTO Self-hosted using Kubernetes and Helm
Enable BigQuery OAuth connections (Helm): For CARTO Self-hosted using Kubernetes and Helm
Configure Single Sign-On (SSO) (Helm): For CARTO Self-hosted using Kubernetes and Helm
Use Workload Identity in GCP (Helm): For CARTO Self-hosted using Kubernetes and Helm
Use EKS Pod Identity in AWS (Helm): For CARTO Self-hosted using Kubernetes and Helm
Enable Redshift imports (Helm): For CARTO Self-hosted using Kubernetes and Helm
Migrating CARTO Self-hosted installation to an external database (Helm): For CARTO Self-hosted using Kubernetes and Helm
Advanced customizations (Helm): For CARTO Self-hosted using Kubernetes and Helm
Configure your custom service account (Helm): For CARTO Self-hosted using Kubernetes and Helm
Load Balancing best practices (Helm)
Tracking Activity Data from Public Maps (Helm)
Maintenance
Maintenance (Kots)
Updates
Backups
Uninstall
Rotating keys
Monitoring
Change the Admin Console password
Maintenance (Helm)
Updates (Helm): For CARTO Self-hosted using Kubernetes and Helm
Monitoring (Helm): For CARTO Self-hosted using Kubernetes and Helm
Rotating keys (Helm): For CARTO Self-hosted using Kubernetes and Helm
Uninstall (Helm): For CARTO Self-hosted using Kubernetes and Helm
Backups (Helm): For CARTO Self-hosted using Kubernetes and Helm
Support: Get support from the CARTO team
Get debug information for Support (Kots): For CARTO Self-hosted using Kots
Get debug information for Support (Helm): For CARTO Self-hosted using Kubernetes and Helm
CARTO Self-hosted Legacy
Key concepts
Architecture
Deployment requirements
Quickstarts
Single VM deployment (docker-compose)
Guides
Configure your own buckets
Configure an external in-memory cache
Enable Google Basemaps
Enable the CARTO Data Warehouse
Configure an external proxy
Enable BigQuery OAuth connections
Configure Single Sign-On (SSO)
Enable Redshift imports
Configure your custom service account
Advanced customizations
Migrating CARTO Self-Hosted installation to an external database
Maintenance
Updates
Backups
Uninstall
Rotating keys
Monitoring
Support
Release Notes: For Self-Hosted deployments
Deploying CARTO using Snowflake Container Services
Legal & Compliance
Previous libraries and components: A comprehensive list of previous components of the CARTO platform not covered in this documentation
Migrating your content to the new CARTO platform

Agent Instructions: Querying This Documentation

If you need additional information, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on a page URL with the ask query parameter:

GET https://docs.carto.com/readme.md?ask=<question>

The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.