> For the complete documentation index, see [llms.txt](https://docs.carto.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.carto.com/carto-user-manual.md). # CARTO User Manual - [Overview](https://docs.carto.com/carto-user-manual/overview.md) - [Creating your CARTO organization](https://docs.carto.com/carto-user-manual/overview/creating-your-carto-organization.md) - [CARTO Cloud Regions](https://docs.carto.com/carto-user-manual/overview/carto-cloud-regions.md) - [CARTO Workspace overview](https://docs.carto.com/carto-user-manual/overview/carto-workspace-overview.md): Learn everything you need to know about your Workspace and how to make the most out of it. - [Projects](https://docs.carto.com/carto-user-manual/projects.md): Organize your maps and workflows into projects and folders, and manage sharing for everything inside from a single place. - [Maps](https://docs.carto.com/carto-user-manual/maps.md) - [Map layout](https://docs.carto.com/carto-user-manual/maps/map-layout.md) - [Data sources](https://docs.carto.com/carto-user-manual/maps/data-sources.md) - [Simple features](https://docs.carto.com/carto-user-manual/maps/data-sources/simple-features.md) - [Spatial Indexes](https://docs.carto.com/carto-user-manual/maps/data-sources/spatial-indexes.md) - [Pre-generated tilesets](https://docs.carto.com/carto-user-manual/maps/data-sources/pre-generated-tilesets.md) - [Rasters](https://docs.carto.com/carto-user-manual/maps/data-sources/rasters.md) - [Defining source spatial data](https://docs.carto.com/carto-user-manual/maps/data-sources/defining-source-spatial-data.md) - [Managing data freshness](https://docs.carto.com/carto-user-manual/maps/data-sources/managing-data-freshness.md) - [Changing data source location](https://docs.carto.com/carto-user-manual/maps/data-sources/changing-data-source-location.md) - [Table and column capitalization](https://docs.carto.com/carto-user-manual/maps/data-sources/table-and-column-capitalization.md) - [Layers](https://docs.carto.com/carto-user-manual/maps/layers.md) - [Point](https://docs.carto.com/carto-user-manual/maps/layers/point.md) - [Grid point aggregation](https://docs.carto.com/carto-user-manual/maps/layers/point/grid-point-aggregation.md) - [H3 point aggregation](https://docs.carto.com/carto-user-manual/maps/layers/point/h3-point-aggregation.md) - [Heatmap point aggregation](https://docs.carto.com/carto-user-manual/maps/layers/point/heatmap-point-aggregation.md) - [Cluster point aggregation](https://docs.carto.com/carto-user-manual/maps/layers/point/cluster-point-aggregation.md) - [Polygon](https://docs.carto.com/carto-user-manual/maps/layers/polygon.md) - [Line](https://docs.carto.com/carto-user-manual/maps/layers/line.md) - [Grid](https://docs.carto.com/carto-user-manual/maps/layers/grid.md) - [H3](https://docs.carto.com/carto-user-manual/maps/layers/h3.md) - [Raster](https://docs.carto.com/carto-user-manual/maps/layers/raster.md) - [Zoom to layer](https://docs.carto.com/carto-user-manual/maps/layers/zoom-to-layer.md) - [Widgets](https://docs.carto.com/carto-user-manual/maps/widgets.md) - [Formula widget](https://docs.carto.com/carto-user-manual/maps/widgets/formula-widget.md) - [Category widget](https://docs.carto.com/carto-user-manual/maps/widgets/category-widget.md) - [Pie widget](https://docs.carto.com/carto-user-manual/maps/widgets/pie-widget.md) - [Histogram widget](https://docs.carto.com/carto-user-manual/maps/widgets/histogram-widget.md) - [Range widget](https://docs.carto.com/carto-user-manual/maps/widgets/range-widget.md) - [Time Series widget](https://docs.carto.com/carto-user-manual/maps/widgets/time-series-widget.md) - [Table widget](https://docs.carto.com/carto-user-manual/maps/widgets/table-widget.md) - [SQL Parameters](https://docs.carto.com/carto-user-manual/maps/sql-parameters.md) - [Date parameter](https://docs.carto.com/carto-user-manual/maps/sql-parameters/date-parameter.md) - [Text parameter](https://docs.carto.com/carto-user-manual/maps/sql-parameters/text-parameter.md) - [Numeric parameter](https://docs.carto.com/carto-user-manual/maps/sql-parameters/numeric-parameter.md) - [Publishing SQL parameters](https://docs.carto.com/carto-user-manual/maps/sql-parameters/publishing-sql-parameters.md) - [Interactions](https://docs.carto.com/carto-user-manual/maps/interactions.md) - [Legend](https://docs.carto.com/carto-user-manual/maps/legend.md) - [Basemaps](https://docs.carto.com/carto-user-manual/maps/basemaps.md) - [Basemap selector](https://docs.carto.com/carto-user-manual/maps/basemaps/basemap-selector.md) - [Map view modes](https://docs.carto.com/carto-user-manual/maps/map-view-modes.md) - [Map description](https://docs.carto.com/carto-user-manual/maps/map-description.md) - [Feature selection tool](https://docs.carto.com/carto-user-manual/maps/feature-selection-tool.md) - [Search locations](https://docs.carto.com/carto-user-manual/maps/search-locations.md) - [Measure distances](https://docs.carto.com/carto-user-manual/maps/measure-distances.md) - [Exporting data](https://docs.carto.com/carto-user-manual/maps/exporting-data.md) - [Download PDF reports](https://docs.carto.com/carto-user-manual/maps/download-pdf-reports.md) - [Exporting map images](https://docs.carto.com/carto-user-manual/maps/exporting-map-images.md) - [Managing maps](https://docs.carto.com/carto-user-manual/maps/managing-maps.md) - [Version history](https://docs.carto.com/carto-user-manual/maps/version-history.md) - [Sharing and collaboration](https://docs.carto.com/carto-user-manual/maps/sharing-and-collaboration.md) - [Editor collaboration](https://docs.carto.com/carto-user-manual/maps/sharing-and-collaboration/collaborative-maps.md) - [Map preview for editors](https://docs.carto.com/carto-user-manual/maps/sharing-and-collaboration/map-preview-for-editors.md) - [Map settings for viewers](https://docs.carto.com/carto-user-manual/maps/sharing-and-collaboration/map-settings-for-viewers.md) - [Comments](https://docs.carto.com/carto-user-manual/maps/sharing-and-collaboration/comments.md) - [Embedding maps](https://docs.carto.com/carto-user-manual/maps/sharing-and-collaboration/embedding-maps.md) - [URL parameters](https://docs.carto.com/carto-user-manual/maps/sharing-and-collaboration/url-parameters.md) - [Performance considerations](https://docs.carto.com/carto-user-manual/maps/performance-considerations.md) - [AI Agents](https://docs.carto.com/carto-user-manual/ai-agents.md) - [Creating your Agent](https://docs.carto.com/carto-user-manual/ai-agents/creating-your-agent.md) - [Agent Config Assistant](https://docs.carto.com/carto-user-manual/ai-agents/agent-config-assistant.md) - [Understanding Agent behavior](https://docs.carto.com/carto-user-manual/ai-agents/understanding-agent-behavior.md) - [Choosing the right model](https://docs.carto.com/carto-user-manual/ai-agents/choosing-the-right-model.md) - [Defining your Agent logic](https://docs.carto.com/carto-user-manual/ai-agents/defining-your-agent-logic.md) - [Semantic model](https://docs.carto.com/carto-user-manual/ai-agents/semantic-model.md) - [Working with tools](https://docs.carto.com/carto-user-manual/ai-agents/working-with-tools.md) - [Configuring capabilities](https://docs.carto.com/carto-user-manual/ai-agents/configuring-capabilities.md) - [Iterate and refine your Agent](https://docs.carto.com/carto-user-manual/ai-agents/iterate-and-refine-your-agent.md) - [Sharing your Agent](https://docs.carto.com/carto-user-manual/ai-agents/sharing-your-agent.md) - [AI Tools Reference](https://docs.carto.com/carto-user-manual/ai-agents/ai-tools-reference.md) - [Workflows](https://docs.carto.com/carto-user-manual/workflows.md) - [Workflow canvas](https://docs.carto.com/carto-user-manual/workflows/workflow-canvas.md) - [Version history](https://docs.carto.com/carto-user-manual/workflows/version-history.md) - [Results panel](https://docs.carto.com/carto-user-manual/workflows/results-panel.md) - [Exporting data](https://docs.carto.com/carto-user-manual/workflows/exporting-data.md) - [Components](https://docs.carto.com/carto-user-manual/workflows/components.md) - [Aggregation](https://docs.carto.com/carto-user-manual/workflows/components/aggregation.md) - [Control](https://docs.carto.com/carto-user-manual/workflows/components/control.md) - [Custom](https://docs.carto.com/carto-user-manual/workflows/components/custom.md) - [Data Enrichment](https://docs.carto.com/carto-user-manual/workflows/components/data-enrichment.md) - [Data Preparation](https://docs.carto.com/carto-user-manual/workflows/components/data-preparation.md) - [Generative AI](https://docs.carto.com/carto-user-manual/workflows/components/generative-ai.md) - [Input / Output](https://docs.carto.com/carto-user-manual/workflows/components/input-output.md) - [Joins](https://docs.carto.com/carto-user-manual/workflows/components/joins.md) - [Parsers](https://docs.carto.com/carto-user-manual/workflows/components/parsers.md) - [Raster Operations](https://docs.carto.com/carto-user-manual/workflows/components/raster-operations.md) - [Spatial Accessors](https://docs.carto.com/carto-user-manual/workflows/components/spatial-accessors.md) - [Spatial Analysis](https://docs.carto.com/carto-user-manual/workflows/components/spatial-analysis.md) - [Spatial Constructors](https://docs.carto.com/carto-user-manual/workflows/components/spatial-constructors.md) - [Spatial Indexes](https://docs.carto.com/carto-user-manual/workflows/components/spatial-indexes.md) - [Spatial Operations](https://docs.carto.com/carto-user-manual/workflows/components/spatial-operations.md) - [Statistics](https://docs.carto.com/carto-user-manual/workflows/components/statistics.md) - [Tileset Creation](https://docs.carto.com/carto-user-manual/workflows/components/tileset-creation.md) - [BigQuery ML](https://docs.carto.com/carto-user-manual/workflows/components/bigquery-ml.md): Extension Package provided by CARTO - [Snowflake ML](https://docs.carto.com/carto-user-manual/workflows/components/snowflake-ml.md): Extension Package provided by CARTO - [Snowflake OpenRouteService](https://docs.carto.com/carto-user-manual/workflows/components/snowflake-ors.md): Extension Package provided by CARTO - [Google Earth Engine](https://docs.carto.com/carto-user-manual/workflows/components/google-earth-engine.md): Extension Package provided by CARTO - [Google Environment APIs](https://docs.carto.com/carto-user-manual/workflows/components/google-environment-apis.md): Extension Package provided by CARTO - [Geospatial Foundation Models](https://docs.carto.com/carto-user-manual/workflows/components/google-pdfm-embeddings.md) - [Telco Signal Propagation Models](https://docs.carto.com/carto-user-manual/workflows/components/telco-signal-propagation-models.md): Extension Package provided by CARTO - [Territory Planning](https://docs.carto.com/carto-user-manual/workflows/components/territory-planning.md) - [Analytics on Embeddings](https://docs.carto.com/carto-user-manual/workflows/components/embedding-analytics.md) - [LGND Embeddings](https://docs.carto.com/carto-user-manual/workflows/components/lgnd-embeddings.md): Extension Package provided by CARTO - [Trajectory Analysis](https://docs.carto.com/carto-user-manual/workflows/components/trajectory-analysis.md): Extension Package provided by CARTO - [Data Sources](https://docs.carto.com/carto-user-manual/workflows/data-sources.md) - [Scheduling workflows](https://docs.carto.com/carto-user-manual/workflows/scheduling-workflows.md) - [Sharing and collaboration](https://docs.carto.com/carto-user-manual/workflows/sharing-workflows.md) - [Viewer Mode](https://docs.carto.com/carto-user-manual/workflows/viewer-mode.md) - [Using variables in workflows](https://docs.carto.com/carto-user-manual/workflows/using-variables-in-workflows.md) - [Executing workflows via API](https://docs.carto.com/carto-user-manual/workflows/executing-workflows-via-api.md) - [Workflows as MCP Tools](https://docs.carto.com/carto-user-manual/workflows/workflows-as-mcp-tools.md) - [Temporary data in Workflows](https://docs.carto.com/carto-user-manual/workflows/temporary-data-in-workflows.md) - [Extension Packages](https://docs.carto.com/carto-user-manual/workflows/extension-packages.md): Private Preview - [Managing workflows](https://docs.carto.com/carto-user-manual/workflows/managing-maps.md) - [Workflows best practices](https://docs.carto.com/carto-user-manual/workflows/how-to-optimize-generated-tables.md) - [Data Explorer](https://docs.carto.com/carto-user-manual/data-explorer.md) - [Creating a map from your data](https://docs.carto.com/carto-user-manual/data-explorer/creating-a-map-from-your-data.md) - [Importing data](https://docs.carto.com/carto-user-manual/data-explorer/importing-data.md) - [Importing rasters with raster-loader](https://docs.carto.com/carto-user-manual/data-explorer/importing-data/importing-rasters.md) - [Geocoding data](https://docs.carto.com/carto-user-manual/data-explorer/geocoding-data.md) - [Optimizing your data](https://docs.carto.com/carto-user-manual/data-explorer/optimizing-your-data.md) - [Data Observatory](https://docs.carto.com/carto-user-manual/data-observatory.md) - [Terminology](https://docs.carto.com/carto-user-manual/data-observatory/terminology.md) - [Browsing the Spatial Data Catalog](https://docs.carto.com/carto-user-manual/data-observatory/accessing-and-browsing-the-spatial-data-catalog.md) - [Subscribing to public and premium datasets](https://docs.carto.com/carto-user-manual/data-observatory/subscribing-to-public-and-premium-datasets.md) - [Accessing free data samples](https://docs.carto.com/carto-user-manual/data-observatory/accessing-free-data-samples.md) - [Accessing your subscriptions from your data warehouse](https://docs.carto.com/carto-user-manual/data-observatory/accessing-your-subscriptions-from-your-data-warehouse.md) - [Access data in BigQuery](https://docs.carto.com/carto-user-manual/data-observatory/accessing-your-subscriptions-from-your-data-warehouse/access-data-in-bigquery.md) - [Access data in Snowflake](https://docs.carto.com/carto-user-manual/data-observatory/accessing-your-subscriptions-from-your-data-warehouse/access-data-in-snowflake.md) - [Access data in Databricks](https://docs.carto.com/carto-user-manual/data-observatory/accessing-your-subscriptions-from-your-data-warehouse/access-data-in-databricks.md) - [Access data in Redshift](https://docs.carto.com/carto-user-manual/data-observatory/accessing-your-subscriptions-from-your-data-warehouse/access-data-in-redshift.md) - [Access data in Oracle](https://docs.carto.com/carto-user-manual/data-observatory/accessing-your-subscriptions-from-your-data-warehouse/access-data-in-oracle.md) - [Access data in PostgreSQL](https://docs.carto.com/carto-user-manual/data-observatory/accessing-your-subscriptions-from-your-data-warehouse/access-data-in-postgresql.md) - [Connections](https://docs.carto.com/carto-user-manual/connections.md) - [Google BigQuery](https://docs.carto.com/carto-user-manual/connections/bigquery.md) - [Snowflake](https://docs.carto.com/carto-user-manual/connections/snowflake.md) - [Databricks](https://docs.carto.com/carto-user-manual/connections/databricks.md) - [Oracle](https://docs.carto.com/carto-user-manual/connections/oracle.md) - [Amazon Redshift](https://docs.carto.com/carto-user-manual/connections/redshift.md) - [PostgreSQL](https://docs.carto.com/carto-user-manual/connections/postgresql.md) - [CARTO Data Warehouse](https://docs.carto.com/carto-user-manual/connections/carto-data-warehouse.md) - [Sharing connections](https://docs.carto.com/carto-user-manual/connections/sharing-a-connection.md) - [Deleting connections](https://docs.carto.com/carto-user-manual/connections/deleting-a-connection.md) - [Required permissions](https://docs.carto.com/carto-user-manual/connections/required-permissions.md) - [IP whitelisting](https://docs.carto.com/carto-user-manual/connections/ip-whitelisting.md) - [Customer data responsibilities](https://docs.carto.com/carto-user-manual/connections/customer-data-responsibilities.md) - [Auditing SQL queries from CARTO](https://docs.carto.com/carto-user-manual/connections/auditing-sql-queries-from-carto.md) - [Applications](https://docs.carto.com/carto-user-manual/applications.md) - [Settings](https://docs.carto.com/carto-user-manual/settings.md) - [Personal settings](https://docs.carto.com/carto-user-manual/settings/personal-settings.md): Manage your CARTO account and check your own consumption - [Quotas & rate limits](https://docs.carto.com/carto-user-manual/settings/quotas-and-rate-limits.md) - [Understanding your organization quotas](https://docs.carto.com/carto-user-manual/settings/quotas-and-rate-limits/understanding-your-organization-quotas.md) - [Usage analytics](https://docs.carto.com/carto-user-manual/settings/quotas-and-rate-limits/usage-analytics.md) - [Managing quotas](https://docs.carto.com/carto-user-manual/settings/quotas-and-rate-limits/managing-quotas.md) - [Rate limits](https://docs.carto.com/carto-user-manual/settings/quotas-and-rate-limits/rate-limits.md) - [Organization Governance](https://docs.carto.com/carto-user-manual/settings/organization-governance.md) - [Activity Data](https://docs.carto.com/carto-user-manual/settings/activity-data.md) - [Activity Data Reference](https://docs.carto.com/carto-user-manual/settings/activity-data/activity-data-reference.md) - [Activity Data Examples](https://docs.carto.com/carto-user-manual/settings/activity-data/activity-data-examples.md) - [Activity Data Changelog](https://docs.carto.com/carto-user-manual/settings/activity-data/activity-data-changelog.md) - [Authentication & SSO](https://docs.carto.com/carto-user-manual/settings/sso.md) - [Users and Groups](https://docs.carto.com/carto-user-manual/settings/users-and-groups.md) - [Inviting users to your organization](https://docs.carto.com/carto-user-manual/settings/users-and-groups/inviting-users-to-your-organization.md) - [Managing user roles](https://docs.carto.com/carto-user-manual/settings/users-and-groups/managing-user-roles.md) - [Deleting users](https://docs.carto.com/carto-user-manual/settings/users-and-groups/deleting-users.md) - [Groups](https://docs.carto.com/carto-user-manual/settings/users-and-groups/managing-user-groups.md) - [Mapping groups to user roles](https://docs.carto.com/carto-user-manual/settings/users-and-groups/mapping-groups-to-user-roles.md) - [SCIM provisioning](https://docs.carto.com/carto-user-manual/settings/users-and-groups/scim-provisioning.md) - [CARTO Support Access](https://docs.carto.com/carto-user-manual/settings/carto-support-access.md) - [Customizations](https://docs.carto.com/carto-user-manual/settings/customizations.md) - [Customizing appearance and branding](https://docs.carto.com/carto-user-manual/settings/customizations/customizing-appearance-and-branding.md) - [Configuring custom color palettes](https://docs.carto.com/carto-user-manual/settings/customizations/configuring-custom-color-palettes.md) - [Configuring your organization basemaps](https://docs.carto.com/carto-user-manual/settings/customizations/configuring-your-organization-basemaps.md) - [Configuring custom markers](https://docs.carto.com/carto-user-manual/settings/customizations/configuring-custom-markers.md) - [CARTO AI](https://docs.carto.com/carto-user-manual/settings/carto-ai.md) - [CARTO AI Analytics](https://docs.carto.com/carto-user-manual/settings/carto-ai/carto-ai-analytics.md) - [Advanced Settings](https://docs.carto.com/carto-user-manual/settings/advanced-settings.md) - [Managing applications](https://docs.carto.com/carto-user-manual/settings/advanced-settings/managing-registered-apps.md) - [Configuring S3 Bucket for Redshift Imports](https://docs.carto.com/carto-user-manual/settings/advanced-settings/configuring-s3-bucket-for-redshift-imports.md) - [Configuring OAuth connections to Snowflake](https://docs.carto.com/carto-user-manual/settings/advanced-settings/configuring-oauth-connections-to-snowflake.md) - [Configuring OAuth U2M connections to Databricks](https://docs.carto.com/carto-user-manual/settings/advanced-settings/configuring-oauth-connections-to-databricks.md) - [Configuring S3 Bucket integration for RDS for PostgreSQL Exports in Builder](https://docs.carto.com/carto-user-manual/settings/advanced-settings/configuring-s3-bucket-integration-for-rds-for-postgresql-exports-in-builder.md) - [Configuring Workload Identity Federation for BigQuery](https://docs.carto.com/carto-user-manual/settings/advanced-settings/workload-identity-federation.md) - [Data Observatory](https://docs.carto.com/carto-user-manual/settings/data-observatory.md) - [Deleting your organization](https://docs.carto.com/carto-user-manual/settings/deleting-your-organization.md) - [Developers](https://docs.carto.com/carto-user-manual/developers.md) - [Managing Credentials](https://docs.carto.com/carto-user-manual/developers/managing-credentials.md) - [API Base URL](https://docs.carto.com/carto-user-manual/developers/managing-credentials/api-base-url.md) - [API Access Tokens](https://docs.carto.com/carto-user-manual/developers/managing-credentials/api-access-tokens.md) - [SPA OAuth Clients](https://docs.carto.com/carto-user-manual/developers/managing-credentials/spa-oauth-clients.md) - [M2M OAuth Clients](https://docs.carto.com/carto-user-manual/developers/managing-credentials/m2m-oauth-clients.md) - [Named Sources](https://docs.carto.com/carto-user-manual/developers/named-sources.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.carto.com/carto-user-manual.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.