Carto.com maps requires an api key

My HA maps say they need a key. Request an API key for CARTO Basemaps | CARTO The key is free for now.

Is there a a configuration option in HA to add the key? Will I need to enter the key per map card?

I’ve previously referenced this doc Map card - Home Assistant to attempt to find an answer.

No. The devs have only just been made aware. Some sort of solution will eventually appear.

Issue has been opened on Github:

Good moment to switch to a different provider or to start on a framework to use other free map providers??

The same for Openstreetmap aswell.

I’m not sure what you mean. Can you clarify a little more.

Sorry My bad. Mixed up a screenshot i saw about API key required


I have a plugin that utilizes Openstreetmap which uses carto, apperently

Looks like the PR for this is good to go Replace CARTO raster tiles with OpenStreetMap vector tiles by bramkragten · Pull Request #53816 · home-assistant/frontend · GitHub

Available now in 2026.9.0b1

…but now it appears I live in a field and there are no roads in Cumbria any more :rofl:

“Roads? Where we’re going, we don’t need roads!”

Fixed it the Beta ?

The roads on my map (with API issue corrected by beta version) appear much fainter than I recall them to be, as well.

Looks like getting an API key is free/instant - just no idea how to actually load it into HomeAssistant.

You don’t need to do anything. Just have a little patience, this has been resolved in the current beta.

Thanks @bob.t - I came here looking for answer to the same question. I appreciate the work being done to restore the map feature.

Home Assisant must replace CARTO to OpenFreeMaps. Without that ridiculous policy of suddenly imposing a key requirement overnight, without any prior notice.

What guarantees that we won’t cut off access to the keys in the future?

Carto API key appears to be free for personal use. I have no issue with signing up and keeping up with my own key, just need a way to install it into HA.

It will be great if we can have an option to use our own self-hosted map service such as Tileserver GL.

Edit: went through the PR does it mean setting up self-hosted map render is just editing the json?

A PR has already been merged to solve the issue.