# Complete Reference guide

- [Welcome – Introduction](https://docs.mapeo.app/complete-reference-guide/welcome.md)
- [Essentials for a successful Mapeo project](https://docs.mapeo.app/complete-reference-guide/essentials-for-a-successful-mapeo-project.md)
- [Planning a Mapeo project](https://docs.mapeo.app/complete-reference-guide/essentials-for-a-successful-mapeo-project/planning.md)
- [What is the project goal?](https://docs.mapeo.app/complete-reference-guide/essentials-for-a-successful-mapeo-project/planning/why-what-is-the-project-goal.md): Why collect information? What is the aim of your mapping, monitoring or data collection, what is your goal or desired end product or result?
- [What outputs do you want?](https://docs.mapeo.app/complete-reference-guide/essentials-for-a-successful-mapeo-project/planning/what-outputs-do-you-want.md)
- [What information to collect?](https://docs.mapeo.app/complete-reference-guide/essentials-for-a-successful-mapeo-project/planning/what-information-to-collect.md)
- [Data types within Mapeo](https://docs.mapeo.app/complete-reference-guide/essentials-for-a-successful-mapeo-project/planning/what-information-to-collect/data-types-within-mapeo.md)
- [Who should be involved and how?](https://docs.mapeo.app/complete-reference-guide/essentials-for-a-successful-mapeo-project/planning/what-are-your-parameters.md): What team structure will best meet your aims; who should be involved, what roles do you need; who is making decisions and who are you accountable to?
- [What are the parameters?](https://docs.mapeo.app/complete-reference-guide/essentials-for-a-successful-mapeo-project/planning/who-is-involved.md): What are the parameters or limiting factors which you are working with? This refers to your geographic context, infrastructure, accessibility to areas, budgets and equipment availability, time const
- [Security & risk assessment](https://docs.mapeo.app/complete-reference-guide/essentials-for-a-successful-mapeo-project/security-and-risk-assessment.md)
- [Creating user protocols](https://docs.mapeo.app/complete-reference-guide/essentials-for-a-successful-mapeo-project/creating-user-protocols.md)
- [Will Mapeo work out-of-the-box for me?](https://docs.mapeo.app/complete-reference-guide/will-mapeo-work-out-of-the-box-for-me.md)
- [Default configuration](https://docs.mapeo.app/complete-reference-guide/will-mapeo-work-out-of-the-box-for-me/default-configuration.md)
- [Default background map](https://docs.mapeo.app/complete-reference-guide/will-mapeo-work-out-of-the-box-for-me/default-base-map.md)
- [Customization options](https://docs.mapeo.app/complete-reference-guide/customization-options.md)
- [Translating Mapeo & default configurations](https://docs.mapeo.app/complete-reference-guide/customization-options/translating.md)
- [Custom configurations](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations.md)
- [Creating custom configurations](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations.md)
- [Planning configuration & data structure](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/planning-configuration-and-data-structure.md)
- [Categories](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/planning-configuration-and-data-structure/categories.md)
- [Icons](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/planning-configuration-and-data-structure/icons.md)
- [Details fields](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/planning-configuration-and-data-structure/details-fields.md)
- [Coding configuration](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/coding-configuration.md)
- [Adding icon files](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/coding-configuration/adding-icon-files.md)
- [Creating and exporting SVG files using Adobe Illustrator](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/coding-configuration/adding-icon-files/creating-and-exporting-svg-files-using-adobe-illustrator.md)
- [Creating and exporting SVG files using Inkscape](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/coding-configuration/adding-icon-files/creating-and-exporting-svg-files-using-inkscape.md)
- [Creating details fields](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/coding-configuration/creating-fields.md)
- [Creating categories](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/coding-configuration/creating-categories.md)
- [Defining geometry defaults](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/coding-configuration/defining-geometry-defaults.md)
- [Adding a project key](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/coding-configuration/adding-a-project-key.md)
- [Adding project name and version](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/coding-configuration/adding-project-name-and-version.md)
- [Building configuration file](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/coding-configuration/building-configuration-file.md)
- [Via the command line](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/coding-configuration/building-configuration-file/preparing-computer.md)
- [Using GitHub Actions](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/coding-configuration/building-configuration-file/using-github-actions.md)
- [Testing and iterating](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-configurations/creating-custom-configurations/testing-and-iterating.md)
- [Custom background maps](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-base-maps.md)
- [Creating custom background maps](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-base-maps/creating-custom-maps.md)
- [Generating map files in .mbtiles format for the experimental Background Maps feature](https://docs.mapeo.app/complete-reference-guide/customization-options/custom-base-maps/creating-custom-maps/creating-mbtiles.md)
- [Mapeo Mobile installation & setup](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-installation-setup.md)
- [Installing Mapeo Mobile](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-installation-setup/installing-mapeo-mobile.md)
- [Choosing Mapeo Mobile settings](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-installation-setup/app-settings.md)
- [Experiments: Turning on experimental features](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-installation-setup/experiments-turning-on-experimental-features.md)
- [Directional Arrow](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-installation-setup/experiments-turning-on-experimental-features/directional-arrow.md)
- [P2P (peer-to-peer) App Updates](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-installation-setup/experiments-turning-on-experimental-features/p2p-peer-to-peer-app-updates.md)
- [Background Maps](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-installation-setup/experiments-turning-on-experimental-features/background-maps.md)
- [Security](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-installation-setup/experiments-turning-on-experimental-features/security.md)
- [App Passcode](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-installation-setup/experiments-turning-on-experimental-features/security/app-passcode.md)
- [Obscure Passcode](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-installation-setup/experiments-turning-on-experimental-features/security/obscure-passcode.md)
- [Importing configurations into Mapeo Mobile](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-installation-setup/importing-configurations.md)
- [Adding custom background maps to Mapeo Mobile](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-installation-setup/adding-custom-base-maps-to-mapeo-mobile.md)
- [Updating Mapeo Mobile](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-installation-setup/updating-mapeo-mobile.md)
- [Mapeo Mobile use](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-use.md)
- [Activating GPS and viewing current location](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-use/activating-gps-and-viewing-current-location.md)
- [Creating observations](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-use/creating-observations.md)
- [Viewing observations](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-use/viewing-observations.md)
- [Editing and deleting observations](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-use/editing-and-deleting-observations.md)
- [Sharing data externally](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-use/sharing-data-externally.md)
- [Syncing data via Wi-Fi](https://docs.mapeo.app/complete-reference-guide/mapeo-mobile-use/wifi-sync.md)
- [Mapeo Desktop installation & setup](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-installation-setup.md)
- [Installing Mapeo Desktop](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-installation-setup/installing-mapeo-desktop.md)
- [Choosing Mapeo Desktop language](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-installation-setup/app-settings.md)
- [Importing configurations to Mapeo Desktop](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-installation-setup/importing-configurations.md)
- [Adding custom background maps to Mapeo Desktop](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-installation-setup/adding-custom-base-maps-to-mapeo-desktop.md)
- [Updating Mapeo Desktop](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-installation-setup/updating-mapeo-desktop.md)
- [Mapeo Desktop use](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use.md)
- [Mapeo Desktop for managing Mapeo Mobile data (Observations mode)](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-manage-mapeo-mobile-data.md)
- [Synchronizing data](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-manage-mapeo-mobile-data/syncing-data.md)
- [Synchronizing via Wi-Fi](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-manage-mapeo-mobile-data/syncing-data/synchronizing-via-wi-fi.md)
- [Synchronizing with a file](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-manage-mapeo-mobile-data/syncing-data/synchronizing-with-a-file.md)
- [Viewing observations](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-manage-mapeo-mobile-data/viewing-observations.md)
- [Editing and deleting observations](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-manage-mapeo-mobile-data/editing-and-deleting-observations.md)
- [Exporting data & sharing externally](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-manage-mapeo-mobile-data/exporting-and-sharing-externally.md)
- [Mapeo Desktop for creating territory data (Territory mode)](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-create-territory-information.md)
- [Navigating around the map](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-create-territory-information/navigating-around-the-map.md)
- [Creating and editing territory data](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-create-territory-information/creating-and-editing-territory-data.md)
- [Changing background maps in Territory mode](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-create-territory-information/changing-basemaps.md)
- [Importing and using external geospatial data](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-create-territory-information/importing-external-territory-information.md)
- [Exporting and syncing data](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/using-mapeo-desktop-to-create-territory-information/exporting-data.md)
- [Synchronizing data with Mapeo Desktop](https://docs.mapeo.app/complete-reference-guide/mapeo-desktop-use/synchronizing-data-with-mapeo-desktop.md)
- [Mapeo trainings](https://docs.mapeo.app/complete-reference-guide/training-and-information-sessions.md)
- [Defining goals and format](https://docs.mapeo.app/complete-reference-guide/training-and-information-sessions/defining-goals-and-format.md)
- [Structuring a training](https://docs.mapeo.app/complete-reference-guide/training-and-information-sessions/structuring-a-training.md)
- [Best practices for planning a training](https://docs.mapeo.app/complete-reference-guide/training-and-information-sessions/structuring-a-training/best-practices-for-planning-a-training.md)
- [Structuring the agenda, content and activities](https://docs.mapeo.app/complete-reference-guide/training-and-information-sessions/structuring-a-training/structuring-the-agenda-content-and-activities.md)
- [Suggestions for the different sections of a training event](https://docs.mapeo.app/complete-reference-guide/training-and-information-sessions/structuring-a-training/structuring-the-agenda-content-and-activities/suggestions-for-the-different-sections-of-a-training-event.md)
- [Tips and suggested activities for training key features of Mapeo](https://docs.mapeo.app/complete-reference-guide/training-and-information-sessions/structuring-a-training/structuring-the-agenda-content-and-activities/tips-and-suggested-activities-for-training-key-features-of-mapeo.md)
- [Materials and resources available for the training event](https://docs.mapeo.app/complete-reference-guide/training-and-information-sessions/structuring-a-training/structuring-the-agenda-content-and-activities/materials-and-resources-available-for-the-training-event.md)
- [Preparing equipment and supplies for a training](https://docs.mapeo.app/complete-reference-guide/training-and-information-sessions/preparing-equipment-and-supplies-for-a-training.md)
- [Recommended equipment and supplies](https://docs.mapeo.app/complete-reference-guide/training-and-information-sessions/preparing-equipment-and-supplies-for-a-training/recommended-equipment-and-supplies.md)
- [Tech preparation before doing in-person training](https://docs.mapeo.app/complete-reference-guide/training-and-information-sessions/preparing-equipment-and-supplies-for-a-training/tech-preparation-before-doing-in-person-training.md)
- [Troubleshooting](https://docs.mapeo.app/complete-reference-guide/troubleshooting.md): Common technical issues
- [I can't start Mapeo](https://docs.mapeo.app/complete-reference-guide/troubleshooting/i-cant-start-mapeo.md)
- [Mapeo closes automatically](https://docs.mapeo.app/complete-reference-guide/troubleshooting/mapeo-closes-automatically.md)
- [I have problems with the GPS in Mapeo](https://docs.mapeo.app/complete-reference-guide/troubleshooting/i-have-problems-with-the-gps-in-mapeo.md)
- [GPS is not activated in Mapeo](https://docs.mapeo.app/complete-reference-guide/troubleshooting/i-have-problems-with-the-gps-in-mapeo/gps-is-not-activated-in-mapeo.md)
- [My GPS signal is very weak](https://docs.mapeo.app/complete-reference-guide/troubleshooting/i-have-problems-with-the-gps-in-mapeo/my-gps-signal-is-very-weak.md)
- [I have problems with the camera in Mapeo](https://docs.mapeo.app/complete-reference-guide/troubleshooting/i-have-problems-with-the-camera-in-mapeo.md)
- [I get a black screen when using the camera](https://docs.mapeo.app/complete-reference-guide/troubleshooting/i-have-problems-with-the-camera-in-mapeo/i-get-a-black-screen-when-using-the-camera.md)
- [I want to update Mapeo Mobile permissions](https://docs.mapeo.app/complete-reference-guide/troubleshooting/updating-mapeo-mobile-permissions.md)
- [I have sync issues](https://docs.mapeo.app/complete-reference-guide/troubleshooting/solving-sync-issues.md)
- [I want to connect to Wi-Fi](https://docs.mapeo.app/complete-reference-guide/troubleshooting/solving-sync-issues/connecting-to-wi-fi.md)
- [I want to create local Wi-Fi networks](https://docs.mapeo.app/complete-reference-guide/troubleshooting/solving-sync-issues/creating-local-wi-fi-networks.md)
- [With a portable router](https://docs.mapeo.app/complete-reference-guide/troubleshooting/solving-sync-issues/creating-local-wi-fi-networks/with-a-portable-router.md)
- [With a smartphone](https://docs.mapeo.app/complete-reference-guide/troubleshooting/solving-sync-issues/creating-local-wi-fi-networks/with-a-smartphone.md)
- [The device I want to sync with does not show up on my Synchronize screen](https://docs.mapeo.app/complete-reference-guide/troubleshooting/solving-sync-issues/the-device-i-want-to-sync-with-does-not-show-up-on-my-synchronize-screen.md)
- [I get an error when I try to sync with another device](https://docs.mapeo.app/complete-reference-guide/troubleshooting/solving-sync-issues/i-get-an-error-when-i-try-to-sync-with-another-device.md)
- [I can't sync with the sync file](https://docs.mapeo.app/complete-reference-guide/troubleshooting/solving-sync-issues/i-cant-sync-with-the-sync-file.md)
- [The person I want to sync with has deleted valuable data](https://docs.mapeo.app/complete-reference-guide/troubleshooting/solving-sync-issues/the-person-i-want-to-sync-with-has-deleted-valuable-data.md)
- [Sharing files between devices](https://docs.mapeo.app/complete-reference-guide/troubleshooting/sharing-files-between-devices.md)
- [Saving and printing Mapeo reference materials](https://docs.mapeo.app/complete-reference-guide/troubleshooting/saving-and-printing-mapeo-reference-materials.md)
- [How do I back up Mapeo Desktop data?](https://docs.mapeo.app/complete-reference-guide/troubleshooting/how-do-i-back-up-mapeo-desktop-data.md)
- [Glossary & quick reference sheets](https://docs.mapeo.app/complete-reference-guide/glossary-and-quick-reference-sheets.md)
- [Glossary of Mapeo related terms](https://docs.mapeo.app/complete-reference-guide/glossary-and-quick-reference-sheets/glossary-of-mapeo-related-terms.md)
- [Overview of Mapeo Desktop Territory mode screen](https://docs.mapeo.app/complete-reference-guide/glossary-and-quick-reference-sheets/overview-of-mapeo-desktop-territory-mode-screen.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mapeo.app/complete-reference-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.