Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions references/chart-types/map.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -87,6 +87,18 @@ For example, if your GeoJSON has a `postal_code` property and your data has a `z
2. Select `postal_code` from the **Map join field** dropdown
3. Select your `zip_code` field as the **Data join field**

##### Custom GeoJSON URL requirements

Lightdash fetches custom GeoJSON files through a server-side proxy that enforces the following requirements:

- The URL must use **HTTPS**.
- The file path must end in `.json`, `.geojson`, or `.topojson`.
- The file must be **10 MB or smaller** and the host must respond within **30 seconds**.
- The host must be a public address. URLs that resolve to private, loopback, link-local, multicast, or carrier-grade NAT IP ranges are rejected.
- **Redirects are not followed.** Host your file at a stable URL that responds with `200 OK` directly.

If a URL fails these checks, the **Map join field** dropdown stays empty and the chart shows an error. Re-upload the file to a public HTTPS host (for example, a CDN or object storage bucket with public read access) and try again.

### Display options

| Option | Description |
Expand Down
Loading