> For the complete documentation index, see [llms.txt](https://docs.mapeo.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mapeo.app/complete-reference-guide.md).

# 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)