Marker icons | Civio Engage Knowledge Base       [ ![Civio Knowledge Base](/civio-light.svg) ](https://nginx.deploy-lagoon-production.civio-engage-docs.dh1.amazee.io)  [Articles](/articles) [Releases](/releases)

   [Home](/)   [Knowledge base](/articles)   [✏️ Content tools ](/articles?category=12)

Marker icons
============

Updated 2 months ago

    Search  Go

   When you add pins to your map layer, you can customise the pins by selecting a marker icon. Marker icons can be either default icons provided by Civio Engage, or custom markers uploaded into the site or project marker icon library.

Marker icon types
-----------------

Civio Engage allows users to choose between the following marker icon options:

- Default marker icon: A marker icon that can be configured by colour and/or size.

![image](/storage/articles/9182182346383.png)

​- Custom marker icon: An icon uploaded by users into a marker icon library. These icons will be available in the Custom marker icon dropdown in the Layer Builder.

​

![image](/storage/articles/9182182347919.png)

​

​Marker icon libraries
---------------------

Civio Engage provides two marker icon libraries where custom markers may be uploaded.

- Site marker library: Icons uploaded in the site marker icon library will be available in the Map Builder for **any** project.
- Project marker library: Icons uploaded in the project marker icon library will be available in the Map Builder **only** for that specific project.

How to find your site marker icon library
-----------------------------------------

1. Click **Content** in the left-hand menu bar. This will show you all the content and engagement tools that apply to your site.
2. Click **Maps.** This provides an overview of all existing maps created on a site level.
3. Select the **Marker icon** tab. This is your site marker icon library.

Finding your project marker icon library
----------------------------------------

1. In the left-hand menu bar, click **Project**.
2. Click on a **Title** to open a project.
3. In the project sub-menu, under **Content**, click **Maps.** This provides an overview of all existing maps created on the project level.
4. Select the **Marker icon** tab. This is your project marker icon library.

Adding a marker to the marker icon library
------------------------------------------

1. Navigate either to your site or project marker icon library (see above for instructions).
2. Click **+** to create a new marker icon.
3. Provide a **Title** and **Summary** (optional)**.**
4. **Upload** an image.
5. Click **Publish**. The custom marker will now be available as a marker icon option when adding pins to a map via **GeoJson Builder.**

Marker icon image upload restrictions
-------------------------------------

Instructions for optimal marker display:

Supported file typesjpeg, jpg, png, svgMax. file upload size10 MBMax. dimensionsWidth = 5000 px, Height = 5000 pxRecommended aspect ratio3:4Editing a marker icon in the library
------------------------------------

1. Navigate either to your site or project marker icon library (see above for instructions).
2. Scroll to select the marker you want to edit, and click on the **ellipsis** at the end of the row. In the dropdown, click **Edit**.
3. When you're finished editing, click **Publish**. The updated custom marker icon will now be available as an option when adding pins to a map via **GeoJson Builder**.

Delete a marker from the library
--------------------------------

1. Navigate either to your site or project marker icon library (see above for instructions).
2. Scroll to select the marker you want to edit in the table, and click on the **ellipsis** at the end of the row. In the dropdown, click **Delete**.
3. A pop-up window will appear to confirm your action. Click **Yes, Delete this marker icon.** *NB: This action cannot be undone!*
4. The marker is now deleted from the library.

 [    Back to articles ](/articles)

  Table of contents
-----------------

    © 2026 [Civio](https://civ.io) [Privacy Policy](/articles/privacy-policy) [Terms of Use](/articles/terms-of-use)