• Ready for review
  • Custom Map Layers

    Professional Business Enterprise

    Custom Map Layers are map layers that are uploaded by the Gruntify users. They appear over the top of the base map and can be used to show organisation specific data. 

    Supported Files and Formats

    Gruntify currently supports GeoJSON formatted files of up to 256MB. If your file is too large then please zip (or compress) the file before uploading.

    The map file must be in the root directory of the Zip file, not in a folder within the Zip file

    • KMZ

    • GeoPackage

    • MapInfo MIF 

    • MapInfo TAB 

    • ESRI Shapefiles 

    • SpatialLite 

    Specific detail on how to upload and use each specific format can be found in the following article:


    Managing Custom Map Layers Video

    The video tutorial below will show you how to import your data to create a custom map layer.

    Custom Map Layer Visibility on the Map

    Visibility of Custom Map Layers is controlled by the Map Options sidebar visible in the Map View.

    This sidebar controls visibility for Custom Map Layers that are available within the workspace.

    Click to Expand - The image and the sidebar
    Click to Expand

    Form Setting: Expand Layer Controls

    There is a Form setting under Menu called Expand Layer Controls. This can be found when creating or editing a Form.

    When this setting is enabled, the location tab of this form whether it is a Request, Job or Asset Form will start with the Map Layer controls sidebar open for all users by default. This is useful when working with multiple layers that may need to be enabled or disabled at different times.

    Whether this setting is enabled or not, users will still be able to manually open the sidebar by clicking the arrow on the right of the map window.

    Importing and Exporting Map Layers

    Similar to Forms, Map Layers can be exported then imported to a new workspace. This is useful when trying to replicate map layers on multiple workspaces as the export also includes specific map layer styling for the custom map layer.

    Automatically Downloading Map Layers on Mobile

    Gruntify Mobile is able to automatically download Custom Map Layers from a workspace on login or when changing workspaces.

    Please click on the expandable the below box for instructions on how to create a custom map layer and set it to automatically download it onto the Gruntify Mobile App.

    This can only be done on the Gruntify Web App by a workspace user with the Owner Role or a Custom Role with the Maps: Manage Maps permission enabled.

    In the Web App

    1. Click on Layers under Maps.

    2. Click on Add Layer button on top-right.

    3. Upload a custom map layer in a supported file format detailed at the top of this article Here.

    4. Click on Options and check the box Automatically download to mobile apps

    5. Click on Create Layer button and wait for it to be processed.


    6. Once map layer is processed then status is changed to Active.

    In the Mobile App

    7. Go-to and click on Download Maps in the sidebar

    7. The map layer is downloaded automatically onto the mobile apps.

    Creating Custom Map Layers from External Data Sources

    Along with importing map layers explained above, external data sources are able to be connected and live updated if the data sources is updated externally. Currently we support links connected to GeoJSON files or ESRI Vector Tiles. Once they are connected, they are able to be styled using the regular styling options or the advanced editor as if they were imported directly.

    If an externally-hosted file is too large, it may only appear at closer zoom levels. If you are unable to see your connected data source, you may be zoomed out too much. Try zooming in until you are able to view your connected or imported map layer.