Upload external map layers | Civio Engage Knowledge Base [Skip to content](#main) [ ![Civio Engage Knowledge Base](/civio-light.svg) ](https://nginx.deploy-lagoon-production.civio-engage-docs.dh1.amazee.io) [Product documentation](/articles) [Release notes](/releases) [Roadmap](/roadmap) [ Support portal ](https://nginx.deploy-lagoon-production.civio-engage-docs.dh1.amazee.io/portal/login) Toggle navigation [Product documentation](/articles) [Release notes](/releases) [Roadmap](/roadmap) [Support portal](https://nginx.deploy-lagoon-production.civio-engage-docs.dh1.amazee.io/portal/login) 1. [Home](/) › 2. [Product documentation](/articles) › 3. [Content tools ](/articles?category=12) › 4. Upload external map layers Upload external map layers ========================== Updated 1 day ago · 6 min read Search Search Whilst we recommend layers to be created within Civio Engage, layers created outside of Civio Engage can be uploaded to your project map How to add an external layer to your map ---------------------------------------- To add external layers to a map: 1. Create a map in the **maps** content and save it, or open an existing map you want to edit. 2. To open the new or existing map, use the top-level menu to navigate to the **Projects** tab. 3. Select the relevant project; this opens your project overview page. 4. In the project sub-menu, under **Content**, click **Maps**. This shows all the maps available for this project. Select the map you would like to add a layer to. 5. Click the **Edit** tab. 6. Scroll down and click **+Add layer.** 7. Select a layer type by choosing either to upload a Shape file, use a GeoJson URL or a GeoJson Raw. 1. For a Shapefile, add a **Title**, upload a valid **Shapefile** .zip file by clicking and browsing, or dragging and dropping the file into the window. *See more information about this layer type further down this page.* 2. For a GeoJson URL, add a **Title**, and provide a valid **GeoJson URL**. If the URL does not provide valid GeoJson the layer will not be visible on the map or an error will display when viewing the map. *See more information about this layer type further down this page.* 3. For a GeoJson Raw, add a **Title**, and paste a valid JSON source in the **GeoJson** field. *See more information about this layer type further down this page.* 8. Style your map layer. *Note: The styling of map layers is only applicable to polygons and shapes.* 1. Adjust the **Border colour** and **Border opacity** using the colour picker and slider. 2. Adjust the **Fill colour** and **Fill opacity** using the colour picker and slider. 3. Adjust the **Border width** and **Border style** using the dropdown fields. 9. Click **Add new Shape file layer** (if you added a shape file), or **Add new GeoJson URL layer** (if you added a GeoJson URL) to finish. 10. Repeat this process until you have added all your desired layers. 11. Click **Publish** to publish the map and its layer(s). ![The Add layer panel on a project map, with GeoJson URL chosen as the layer type and its Title and URL fields visible.](https://engage.knowledge.civ.io/storage/QkaYDMcXYGxOco3PomdDZF9guKumugaX2SvkhKV1.png) Option 1. Use a Shapefile ------------------------- A Shapefile is a format for storing geospatial data that can be added to a map as a layer. It is a standardised structure and can be recognised or generated by most mapping services. Maps in Civio Engage support adding Shapefiles through uploading an existing Shapefile that has been created outside Civio Engage. How to create a Shapefile ------------------------- 1. Use your existing tools: If you already use a map service for interacting with geospatial or mapping data, it likely supports Shapefiles. Read the documentation or ask support for how to create a Shapefile you want to add to your map. 2. Use Geojson: Geojson.io is an excellent free tool for creating shapefiles, the following is a very brief getting started guide, however, we recommend reading their help to fully understand the capabilities. 1. Visit geojson.io, and start building the shape you would like to add to your map by using the toolbar on the right-hand side. 2. Once complete, click Save then Shapefile. A .zip file of your Shapefile will be downloaded and saved to your computer. Option 2. Use a GeoJSON URL --------------------------- GeoJSON is a format for storing geospatial data that can be added to a map as a layer. It is a standardised structure and can be recognised or generated by most mapping services. ### Adding GeoJSON to maps Maps in Civio Engage support adding GeoJSON via a remote URL. This means the GeoJSON is hosted elsewhere, and the maps will fetch and load the data when the map is rendered on the page. ### How to create GeoJSON If you already use a map service for interacting with geospatial or mapping data, it likely supports GeoJSON. Read the documentation or ask support for how to create a GeoJSON URL for the data you want to add to your map. Option 3. Use JSON in Layer Builder ----------------------------------- When your external layer contains pins, and you wish to display descriptive information per individual pin on the map, we recommend you to follow the below steps instead of using the shape file or GeoJSON URL: 1. Create a map in the **maps** content and save it, or open an existing map you want to edit. 2. To open the new or existing map, use the top-level menu to navigate to the **Projects** tab. 3. Select the relevant project; this opens your project overview page. 4. In the project sub-menu, under **Content**, click **Maps**. This shows all the maps available for this project. Select the map you would like to add a layer to. 5. Click the **Edit** tab. 6. Scroll down and click **+Add layer.** 7. Select the **GeoJson Builder** type from the dropdown. 8. Click **Configure new map layer**. 9. This will open a lightbox window. On the right hand side of the lightbox, click the **JSON** tab. Paste the JSON of your pin layer in the field. 10. Click **save**. The lightbox will now close. The pins have now been added to the layer. 11. To add a title and description to each individual pin on the map, click **Edit map layer**. This will open the map builder lightbox. Click on an individual pin on the map and add a Title and Description in the right-hand sidebar. Click Done. Repeat this process for each pin. 12. When you are done, click **save**. The lightbox will close, and the titles and descriptive text that you have added to the pins will be visible. 13. Click **Add new GeoJson Builder layer**. 14. Click **Publish** to publish the map and its layer(s). ![The Layer Builder flow: pasting JSON to plot pins on a map, then clicking one pin to add its own title and description.](https://engage.knowledge.civ.io/storage/KUHWRwQpPXAy0I3gW76bhM5GYhoNhutrn5SJY7dH.gif) Option 4: Use JSON raw ---------------------- You can also choose to copy and paste the JSON of your pin layer without accessing the **Edit map layer** functionality: this means that you won't be able to customise any pin on the map. To use the JSON raw: 1. Create a map in the **maps** content and save it, or open an existing map you want to edit. 2. To open the new or existing map, use the top-level menu to navigate to the **Projects** tab. 3. Select the relevant project; this opens your project overview page. 4. In the project sub-menu, under **Content**, click **Maps**. This shows all the maps available for this project. Select the map you would like to add a layer to. 5. Click the **Edit** tab. 6. Scroll down and click **+Add layer.** 7. Select **GeoJson Raw.** 8. Add a **Title** and paste the JSON of your pin layer in the **GeoJson** field. 9. Style your map layer. *Note: The styling of map layers is only applicable to polygons and shapes.* 1. Adjust the **Border colour** and **Border opacity** using the colour picker and slider. 2. Adjust the **Fill colour** and **Fill opacity** using the colour picker and slider. 3. Adjust the **Border width** and **Border style** using the dropdown field. 10. Click **Add new GeoJson Raw layer**. 11. Click **Publish** to publish the map and its layer(s). ![The Add GeoJson Raw panel, with a valid GeoJSON FeatureCollection pasted into the highlighted GeoJson field, above the collapsed Style settings and the Add new GeoJson Raw layer button.](https://engage.knowledge.civ.io/storage/O1mDTW4oGlKbvsIbprpnUb0brmWbhCp4pCWZCDka.png) Was this article helpful? ------------------------- Your feedback helps us prioritise what to rewrite. Yes No [ Back to Content tools ](/articles?category=12) On this page ### Still need help? Raise a request in the support portal and track it to resolution. [ Submit a support request ](https://nginx.deploy-lagoon-production.civio-engage-docs.dh1.amazee.io/portal/login) Submit a support request through the [support portal](/portal) or email . © 2026 [Civio](https://civ.io) [Privacy Policy](/articles/privacy-policy) [Terms of Use](/articles/terms-of-use)