Skip to content

Quickstart: 5-Minute Tutorial

Follow these quick steps to create your first GeoSight dashboard using sample data.


Step 1: Prepare a Reference Dataset

Reference datasets define the administrative boundaries used in your analysis.

  1. Navigate to Reference Datasets → Create New Reference Dataset.

  2. Enter a name (e.g. Somalia Districts).

  3. Click Add new level and define your admin level (e.g. District).

  4. Click Submit.


    Create Reference Dataset
    Image credit: GeoSight


  5. In the top-right corner, click Import Data and upload a supported file.

  6. Select the name and unique code fields, then click Submit.


    Config Reference Dataset
    Image credit: GeoSight


📝
You can also connect to GeoRepo instead of uploading your own boundary data.


Step 2: Create an Indicator

Indicators represent the data you want to visualise.

  1. Go to Indicators → Create New Indicator.

  2. Enter a name (e.g. Sample Indicator A).

  3. Add a shortcode (e.g. SAMPLE_IND_A).

  4. Assign or create a category.

  5. Click Save.


Create Indicator
Image credit: GeoSight


Step 3: Import Indicator Data

Upload and link your data to the indicator so it can be visualised on the map.

  1. Open your indicator and in the top-right corner, click Import Data.

  2. Under the General tab, set the following:


    Setting Value
    Import Type Indicator Value
    Input Format Excel Long Format


    General Tab
    Image credit: GeoSight


  3. Under the Attributes tab, click Choose File and upload your Excel file.


    Attributes Tab
    Image credit: GeoSight


  4. In the Reference Layer & Time tab select your reference dataset.

  5. Configure the date field settings.

  6. Click Submit.


    Reference Layer & Time Tab
    Image credit: GeoSight


  7. After your data has been uploaded, click See the data.

  8. Click Select all 148 data.

  9. Click Save.


Data Records
Image credit: GeoSight


Step 4: Add a Basemap

Add a basemap to provide geographic context for your data.

  1. Navigate to Basemaps → Create New Basemap.

  2. Enter the following:


    Field Value
    Name OpenStreetMap
    URL https://a.tile.openstreetmap.org/{z}/{x}/{y}.png?noWrap=true
    Type XYZ Tile
    Category Road Maps


  3. Click Save.


Create Basemap
Image credit: GeoSight


Step 5: Create a Dashboard

Combine your data, layers, and settings into a single interactive dashboard.

  1. Go to Projects → Create New Project.

  2. On the General tab, enter a name (e.g. First Project) for your project.

  3. Select your View (e.g. Somalia Districts).


    General Tab
    Image credit: GeoSight


  4. Navigate to Indicators → Add Indicator.

  5. Select Sample Indicator A and click Update Selection.


    Indicators Tab
    Image credit: GeoSight


  6. Navigate to Indicator Layers → Add Indicator Layer.

  7. Choose Single Indicator Layer.

  8. Select Sample Indicator A and click Apply Selection.


    Indicator Layers Tab
    Image credit: GeoSight


  9. Navigate to Basemaps → Add Basemap.

  10. Select Open Street Map and click Update Selection.

  11. Click Save.


    Indicator Layers Tab
    Image credit: GeoSight


Step 6: Preview Your Dashboard

Open and explore your dashboard to see your data in action.

  1. Click Preview to open your dashboard.

  2. Explore your data using maps, filters, and widgets.


New Project
Image credit: GeoSight
Preview Project
Image credit: GeoSight


Next up: Learn how to navigate and interact with the GeoSight interface for a seamless user experience.