> For the complete documentation index, see [llms.txt](https://help.horizon.globalnaturewatch.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.horizon.globalnaturewatch.org/resources/quickstarts/how-to-add-your-own-area-to-gnw-horizon.md).

# How to add your own area to GNW Horizon

Upload a boundary file or draw your area on the map, then analyze it or build a dashboard for it. Takes about five minutes.

{% hint style="info" %}
**Goal**&#x20;

By the end of this guide, your own area of interest is saved in GNW Horizon, named the way you want, and ready to analyse.&#x20;
{% endhint %}

{% hint style="warning" %}
**Coming from Global Forest Watch?**&#x20;

* You can reuse most boundary files you uploaded to GFW. Zipped shapefiles and GeoJSON files work in Horizon. CSV files work too, as long as they hold polygons (see Prepare your file below).&#x20;
* KML files are not supported yet. KML and point with radius upload are coming soon. For now, convert a KML file to GeoJSON in QGIS or another GIS tool.&#x20;
* Each area must be between 10 hectares and 10,000 km². Very large GFW areas may need to be split.&#x20;
* GeoJSON uploads get a name assigned by Horizon. You can rename the area after upload.&#x20;
  {% endhint %}

### What you need&#x20;

* Your boundary as a .geojson, .csv or zipped shapefile (.zip), or a rough idea of the boundary so you can draw it.&#x20;
* Optional: QGIS (free) or another GIS tool to check or fix your file.&#x20;

### Choose how to add your area&#x20;

| Method                    | Best for                                                     | Where to start            |
| ------------------------- | ------------------------------------------------------------ | ------------------------- |
| A. Upload a file          | Exact boundaries you already have (CSV or shapefile)         | Map > Areas > Upload file |
| B. Draw on map            | A quick, approximate boundary when you do not have a file    | Map > Areas > Draw on map |
| C. Upload from Dashboards | Going straight to monitoring: a dashboard is created for you | Dashboards > Upload area  |

#### Option A: Upload a file&#x20;

1. Select Map in the top bar. Below the assistant chat box, select Areas.&#x20;

<figure><img src="https://213166889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpN6g4jM2ghngm26l7cbt%2Fuploads%2Fb0d8KdqXgvflDNYjRHrv%2F01_areas_button.png?alt=media&amp;token=dff53c92-ea83-4683-87e6-a28bd5a9d278" alt=""><figcaption></figcaption></figure>

2. At the top of the Areas panel, select Upload file.

<figure><img src="https://213166889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpN6g4jM2ghngm26l7cbt%2Fuploads%2FRmEtKc1hOCy8mpfJg4sb%2F02_upload_file_button.png?alt=media&amp;token=7208b3d3-1761-40f1-98db-4773018f83cf" alt=""><figcaption></figcaption></figure>

3. In the Upload Area window, drag your file into the box, or select Select File. The window lists the accepted file types and limits.

<figure><img src="https://213166889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpN6g4jM2ghngm26l7cbt%2Fuploads%2FeXpdIn8cC85oQeVyitbU%2F03_upload_dialog.png?alt=media&amp;token=99f39617-b72c-4611-bc27-b2bb808d8f9d" alt=""><figcaption></figcaption></figure>

4. Check the file name, then select Upload. If the file has a problem, a red message appears instead. See If you see this error below.

<figure><img src="https://213166889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpN6g4jM2ghngm26l7cbt%2Fuploads%2FBzbLq8h7IsyvTnU9MI5B%2F04_file_selected.png?alt=media&amp;token=404990a4-3fe7-4453-bc88-bf7d5aa88697" alt=""><figcaption></figcaption></figure>

5. Horizon zooms to your area, outlines it on the map and adds it to the AI-assistant pane as context. GeoJSON uploads get a name assigned by Horizon (e.g.: "Pristine Valley").

<figure><img src="https://213166889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpN6g4jM2ghngm26l7cbt%2Fuploads%2FqZqEZGXFeykPMQA1Lzwd%2F05_area_on_map.jpg?alt=media&amp;token=8a75ad13-3c77-4528-8f76-79779a206084" alt=""><figcaption></figcaption></figure>

6. Check the location. Make sure the outline is where you expect. If it is in the wrong place (for example, in the ocean), your latitude and longitude could be swapped.
7. Rename the area. In the Areas panel, select My areas, select the three dots next to your area, then Rename. Type a name and select Save.

<figure><img src="https://213166889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpN6g4jM2ghngm26l7cbt%2Fuploads%2F3lITX630rHnBUWrR8JIn%2F06_my_areas_rename.png?alt=media&amp;token=420dd8ff-ffac-4a5f-9c4c-d8f94c3d0252" alt=""><figcaption></figcaption></figure>

<figure><img src="https://213166889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpN6g4jM2ghngm26l7cbt%2Fuploads%2FZGuMoIjoCgxc20U4nM0W%2F07_rename_dialog.png?alt=media&amp;token=a3b21ee8-909f-4aca-b3be-b3ba974b8df2" alt=""><figcaption></figcaption></figure>

Tip: select the target icon next to an area in My areas to centre the map on it.

#### Option B: Draw on map&#x20;

1. Select Map, then Areas. Zoom in to your area first: drawn areas are limited to 10,000 km².&#x20;
2. In the Areas panel, select Draw on map.&#x20;

<figure><img src="https://213166889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpN6g4jM2ghngm26l7cbt%2Fuploads%2FdrBEOHC2rZUMqEnmLKQy%2F09_draw_on_map_button.png?alt=media&amp;token=e9f5fb8d-9f54-4144-8bf9-e51c59e6384e" alt=""><figcaption></figcaption></figure>

3. Click the map to add points around your area. Double-click to add the last point and finish.

<figure><img src="https://213166889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpN6g4jM2ghngm26l7cbt%2Fuploads%2FWad95cIEpobE4YYOqvj7%2F10_draw_in_progress.jpg?alt=media&amp;token=1748fae2-411e-4d92-87d0-3a1c0885e8ec" alt=""><figcaption></figcaption></figure>

4. Horizon suggests a name for the area. Select Save area to keep it, Redraw to start again, or Cancel.

<figure><img src="https://213166889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpN6g4jM2ghngm26l7cbt%2Fuploads%2FwvzfgiQhzz5BWBKklAIi%2F11_draw_save_area.png?alt=media&amp;token=0dd3e435-45b9-4551-a9b1-69ef14633677" alt=""><figcaption></figcaption></figure>

If your shape is too big, Horizon shows the size and the limit. Select Try again and draw a smaller area.

<figure><img src="https://213166889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpN6g4jM2ghngm26l7cbt%2Fuploads%2FOsrlUVpwCpnNjhP9h2rE%2F12_draw_too_large.png?alt=media&amp;token=695bcf66-c33b-4e99-9cd5-d49515e0e696" alt=""><figcaption></figcaption></figure>

#### Option C: Upload from Dashboards&#x20;

1. Select Dashboards in the top bar. Under Create new dashboard, select Upload area.&#x20;

<figure><img src="https://213166889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpN6g4jM2ghngm26l7cbt%2Fuploads%2FbgTFbyhbHNzT7bBH7Yqh%2F13_dashboards_upload_area.png?alt=media&amp;token=4cf0db59-96b3-490f-b240-9b7cf8173075" alt=""><figcaption></figcaption></figure>

2. Upload your file in the same Upload Area window as Option A.&#x20;
3. Horizon creates a dashboard for your area straight away and opens it. Start with an analysis template, such as Near real-time monitoring or Post-2020 forest loss, or ask the assistant to add charts, maps and imagery.&#x20;

#### What you can do with your area&#x20;

Select the three dots on the area label on the map to:&#x20;

* Generate Insights or View Analysis for the area&#x20;
* Create Dashboard to monitor the area over time&#x20;
* Remove from map (the area stays saved in My areas)&#x20;

<figure><img src="https://213166889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpN6g4jM2ghngm26l7cbt%2Fuploads%2FAdQITkFQVI14C4gCXf07%2F08_area_menu.png?alt=media&amp;token=7bdb9d3c-4440-43a9-a065-3327ed384720" alt=""><figcaption></figcaption></figure>

Your areas are listed under **Map > Areas > My areas** and under **Dashboards > Create new dashboard > Custom areas**.&#x20;

### Prepare your file&#x20;

Use a CSV or zipped shapefile when you have several areas: each row or feature becomes its own area, named from your file.&#x20;

| **Format**              | **Size limit** | **Areas created** | **Area name**                            | **Must include**                                                             |
| ----------------------- | -------------- | ----------------- | ---------------------------------------- | ---------------------------------------------------------------------------- |
| GeoJSON (.geojson)      | 1 MB           | One per file      | Assigned by Horizon; rename after upload | A Polygon or MultiPolygon                                                    |
| CSV (.csv)              | 10 MB          | One per row       | From the name column                     | A name column and a geom column of WKT polygons in longitude, latitude order |
| Zipped shapefile (.zip) | 10 MB          | One per feature   | From the name attribute                  | The .shp, .shx, .dbf and .prj files, and a name attribute                    |

&#x20;

A CSV row looks like this:&#x20;

```
name,geom 
Farm 12,"POLYGON ((-63.10 -9.90, -63.07 -9.90, -63.07 -9.87, -63.10 -9.87, -63.10 -9.90))" 
```

We are working to align the three formats to have the same requirements, and to provide additional formats in the future. &#x20;

#### Before you upload: checklist&#x20;

1. **The file extension is .geojson, .csv or .zip.** A .json or .kml file is rejected. Rename a .json file to .geojson; convert KML to GeoJSON first.&#x20;
2. **The file is within the size limit:** 1 MB for GeoJSON, 10 MB for CSV and zipped shapefiles. Simplify the boundary or reduce coordinate precision if needed.&#x20;
3. **The geometry is a polygon.** Polygon and MultiPolygon are both accepted. Points and lines are rejected; buffer them into polygons in your GIS tool first.&#x20;
4. **Each area is between 10 hectares (0.10 km²) and 10,000 km².** Split very large areas into smaller ones.&#x20;
5. **A GeoJSON file holds one area.** A GeoJSON file with several features creates only one area. To upload several areas at once, use a CSV or zipped shapefile.&#x20;
6. **The boundary is closed and does not cross itself.** The first and last coordinates must match. Fix in QGIS: Vector > Geometry Tools > Fix Geometries.&#x20;
7. **Coordinates are in longitude, latitude order.** Swapped coordinates are not flagged: the file uploads, but the area lands somewhere else in the world. This often happens when building a file from a spreadsheet.&#x20;
8. **Areas made of separate parcels** (one MultiPolygon with parts that do not touch) upload as one area, and analysis covers every part. The map may only outline one part. To see and analyse each parcel on its own, upload them as separate rows in a CSV or separate features in a shapefile.&#x20;
9. **No need to fix** a "crs" block or the direction of your boundary points. Horizon accepts both.&#x20;

#### If you see this error&#x20;

| **Message**                                                        | **What it means**                                          | **Fix**                                                        |
| ------------------------------------------------------------------ | ---------------------------------------------------------- | -------------------------------------------------------------- |
| "Only .geojson, .csv, .zip files are supported"                    | Wrong file type, for example .json or .kml                 | Rename .json to .geojson, or convert the file                  |
| "File size exceeds 1MB limit"                                      | GeoJSON file is over 1 MB                                  | Simplify the boundary, or use a zipped shapefile (10 MB limit) |
| "No valid Polygon or MultiPolygon features found"                  | The file has no polygons, for example only points or lines | Re-export or buffer the area as a polygon                      |
| "Area is too small (X km²). Minimum area is 0.10 km²."             | The area is under 10 hectares                              | Use a larger boundary, or check for swapped coordinates        |
| "Area is too small (0.000 km²)" for an area that is clearly larger | The boundary crosses itself                                | Run Fix Geometries in QGIS, then upload again                  |
| "Area is too large (X km²). Maximum is 10,000 km²."                | The area is over 10,000 km²                                | Split it into smaller areas                                    |
| "Failed to process file. Please try again."                        | Often a boundary that is not closed                        | Make the first and last coordinates match, then upload again   |
| No error, but the area is in the wrong place                       | Latitude and longitude are swapped                         | Swap to longitude, latitude order and upload again             |
| No error, but fewer areas than expected                            | A GeoJSON file with several features creates one area      | Upload a CSV or zipped shapefile, or one GeoJSON file per area |

<figure><img src="https://213166889-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpN6g4jM2ghngm26l7cbt%2Fuploads%2Fyuk88aNG4r9oDwyftiT8%2F14_error_wrong_format.png?alt=media&amp;token=adb4af2f-db1a-4f9a-9f86-7849e1ecf73b" alt=""><figcaption></figcaption></figure>

*Example: an unsupported file type shows a red message under the upload box.*

**Try this prompt**

{% hint style="info" %}
**Copy into the assistant**&#x20;

"*Give me a summary of land cover change in \[your area name] over the last five years."*
{% endhint %}

#### What to do next&#x20;

* Ready to explore your area? Try [**Run your first analysis**](https://help.horizon.globalnaturewatch.org/~/revisions/2tSrFcLvZtdKAnw9qNkr/resources/quickstarts/run-your-first-analysis)**.**&#x20;
* Want to check forest loss since 2020? Try Check post-2020 forest loss and alerts for your area.&#x20;
* Want to track the area over time? Try Create a dashboard.&#x20;

| Test                                                               | Route              | Result                                                                                                                                                                                                           |
| ------------------------------------------------------------------ | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| GeoJSON over 1 MB (1.4 MB)                                         | Map                | Rejected: "File size exceeds 1MB limit"                                                                                                                                                                          |
| KML file                                                           | Map                | Rejected: "Only .geojson, .csv, .zip files are supported"                                                                                                                                                        |
| GeoJSON, about 17,600 km²                                          | Map                | Rejected: "Area is too large (17,604 km²). Maximum is 10,000 km²."                                                                                                                                               |
| Drawn area, about 148,700 km² and 12,700 km²                       | Draw on map        | Rejected: "Area too large: X km². Maximum is 10,000 km²." with Try again                                                                                                                                         |
| Drawn area under 10,000 km²                                        | Draw on map        | Accepted; suggested name "Upper Chari River Basin" (cancelled, not saved)                                                                                                                                        |
| GeoJSON with "crs" block                                           | Map                | Accepted ("Remote Ridge")                                                                                                                                                                                        |
| GeoJSON, clockwise ring                                            | Map                | Accepted ("Vibrant Lake")                                                                                                                                                                                        |
| Self-crossing (bowtie) ring                                        | Map and Dashboards | Rejected: "Area is too small (0.000 km²)"                                                                                                                                                                        |
| Unclosed ring                                                      | Map                | Rejected: "Failed to process file. Please try again."                                                                                                                                                            |
| MultiPolygon, two separate parts, large part first                 | Map                | Accepted as one area ("Vibrant Grove"); only first part outlined                                                                                                                                                 |
| MultiPolygon, small part (about 5 ha) first, large part 11 km away | Map                | Accepted ("Remote Peak"), so the size check counts both parts. Tree cover loss chart showed about 55 ha in 2001, more than the small part alone, so analysis covers both parts. Only the small part is outlined. |
| Valid GeoJSON with a "name" property                               | Map                | Accepted; name ignored, assigned "Pristine Valley"; renamed to "Farm boundary"                                                                                                                                   |
| Valid GeoJSON                                                      | Dashboards         | Accepted; dashboard "Hidden Grove" created and opened                                                                                                                                                            |
