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.
nedberg
(Even Nedberg)
August 26, 2026, 1:59pm
3
Issue has been opened on Github:
opened 11:43AM - 26 Aug 26 UTC
### Checklist
- [x] I have updated to the latest available Home Assistant versi… on.
- [x] I have cleared the cache of my browser.
- [x] I have tried a different browser to see if it is related to my browser.
- [ ] I have tried reproducing the issue in [safe mode](https://www.home-assistant.io/blog/2023/11/01/release-202311/#restarting-into-safe-mode) to rule out problems with unsupported custom resources.
### Describe the issue you are experiencing
All of a sudden, the map tiles in map view started to show a message that an API key is needed, pointing to https://carto.com/basemaps/apikey/
<img width="1148" height="702" alt="Image" src="https://github.com/user-attachments/assets/d05e4336-6862-4232-8916-e3a5aee861c4" />
### Describe the behavior you expected
No watermark should be visible
### Steps to reproduce the issue
1. Open the map view
### What version of Home Assistant Core has the issue?
2026.8.3
### What was the last working version of Home Assistant Core?
2026.8.3
### In which browser are you experiencing the issue?
Firefox, Google Chrome
### Which operating system are you using to run this browser?
macOS Tahoe
### State of relevant entities
```txt
```
### Problem-relevant frontend configuration
```yaml
```
### JavaScript errors shown in your browser console/inspector
```txt
```
### Additional information
_No response_
Good moment to switch to a different provider or to start on a framework to use other free map providers??
Letalis
(Letalis)
August 27, 2026, 2:09pm
5
The same for Openstreetmap aswell.
I’m not sure what you mean. Can you clarify a little more.
Letalis
(Letalis)
August 27, 2026, 2:38pm
7
Sorry My bad. Mixed up a screenshot i saw about API key required
I have a plugin that utilizes Openstreetmap which uses carto, apperently
dcapslock
(Darryn Capes-Davis)
August 28, 2026, 12:06am
9
Available now in 2026.9.0b1
…but now it appears I live in a field and there are no roads in Cumbria any more
iota
(Jason)
August 28, 2026, 12:55pm
11
“Roads? Where we’re going, we don’t need roads!”
bob.t
(Bob)
August 29, 2026, 2:10pm
13
The roads on my map (with API issue corrected by beta version) appear much fainter than I recall them to be, as well.
quaka
August 30, 2026, 5:34am
14
Looks like getting an API key is free/instant - just no idea how to actually load it into HomeAssistant.
bob.t
(Bob)
August 30, 2026, 10:40am
15
You don’t need to do anything. Just have a little patience, this has been resolved in the current beta.
KBActive
(Barry K)
August 30, 2026, 1:07pm
16
Thanks @bob.t - I came here looking for answer to the same question. I appreciate the work being done to restore the map feature.
VCTGomes
(Vitor Gomes)
August 30, 2026, 2:41pm
17
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?
jaknz
(Jeremy)
August 31, 2026, 3:20am
18
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.
Scoops
August 31, 2026, 1:03pm
19
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?
Rudd-O
(Rudd-O)
September 1, 2026, 2:11pm
20
A PR has already been merged to solve the issue.