Docs > Configuration > Dashboard Creation > Mobile Dashboard Configuration

Mobile Dashboard Configuration


Mobile Dashboard Configuration is a page used for creating and managing Mobile Dashboards and then adding Mobile Visualizations to the Dashboard. As web-based visualizations can’t be directly visualized on mobile.

The vuSmartMaps™ platform supports a Mobile Application for viewing certain visualizations like KPI, Table, Charts, and Insights. You can configure the dashboards and visualizations for Mobile Application using Mobile Dashboard Configuration. 

To access Mobile Dashboard: Left Navigation menu > Configure Observability > Mobile Dashboard.

On clicking, you will be redirected to the Mobile dashboard landing page.

Accessing the Mobile Dashboard tab allows you to initiate the following configuration actions.

  1. Mobile Dashboard Listing Page:
    •    View, edit, or delete existing Mobile Dashboards.
    •    Add new Mobile Dashboards.
  1. Mobile Dashboard Configuration Page:
    •    Customize the Dashboard name and description.
    •    Enable or disable Dashboards.
    •    Add Visualizations, specifying type and data model.
  1. Data Model Creation Details:
    •    Ensure metrics are included for mobile app display.
    •    KPI needs numerical aggregation with no groupings.
    •    Charts require time-series data.
    •    Table visualizations require grouping fields without metric overlap.
  1. Import/Export Mobile Dashboards:
    •    Easily manage Dashboards with ‘Import’ and ‘Export’ buttons.
    •    Prevent duplicates when importing Mobile Dashboards.

Configure Mobile Dashboards and Visualizations for a seamless mobile experience with vuSmartMaps Mobile Application.

The detailed steps for Mobile Dashboard configuration are as follows:

Mobile Dashboard Listing Page

After selecting the Mobile Dashboard tab, you’ll see a list of existing Mobile Dashboards.

This landing page has the following items:

  1. A table containing the list of Dashboards.
  2. Description – The description of the Dashboard.
  3. Status of the Dashboards (Enabled/Disabled)  – Only if a Dashboard is enabled then it will be shown in the Mobile Application, even though the dashboard has been assigned to the mobile user.
  4. Created By – The information on the user who originally created the Dashboard.
  5. Created At– The information on the date and time when the Dashboard was originally created.
  6. Modified By – The information on the user who modified the Dashboard recently.
  7. Modified At– The information on the date and time when the Report was modified.  
  8. Actions– Edit and Delete option for the Dashboard.
  9. Click on the + icon to add a Mobile Dashboard. It will redirect to the Mobile Dashboard Configuration page.
  10. Enter the details of the mobile dashboard.

Mobile Dashboard Configuration Page

There are 4 items that can be configured here:

  • Name of the Dashboard

Provide a unique name (editable). For example: Insights

💡Note: Use unique names while creating Mobile Dashboards to prevent error messages.

  • Description of the Dashboard

This optional field lets you provide a description for the Dashboard, typically used for grouping related visualizations.

  • Enable or Disable the Dashboard

You can toggle the Dashboard on or off from this page or the Mobile Dashboard listing page.

  • Adding Visualizations

To input values into the Visualizations Table, click the + icon in the Visualizations section and provide the necessary information for the Visualization. The required information includes:

  1. Select Visualization Type: Type of Visualization.
    • Data Model
    • Insights

💡Note: HTML insights with JS is not supported yet.

  1. Select Visualization: Lists available Data Models or Insights based on the “Select Visualization Type.

3. Select Rendering Type (Available only when Data Model is selected on Select Visualization Type): Type of Rendering required.

  • KPI
  • Table
  • Trend Chart

💡NoteIf the specific Data Model for the particular type of visualization is not selected, the dashboards in the mobile app will not function properly.

Refer to Data Model Creation Details

Adding Visualization

  1. You can preview the selected Data Model by choosing it from the Select Visualization Type dropdown.

  1. Clicking the + icon next to Select Visualization redirects to Data Model creation (if Data Model is selected) or Dashboard creation (if Insights is selected on the  Select Visualization Type dropdown).
  2. Upon clicking Add, a new entry appears at the top of the Visualizations Table. Rearrange the order using the Up and Down arrow icons under the Actions column. The order in this module determines the display sequence in the Mobile Application.

💡Note: The visualization list may be edited with the Edit button available under the Actions column.

  1. After clicking Save, the mobile dashboard is created and listed in saved Mobile Dashboards.

💡Note: Mobile dashboards can be edited using the Edit button under the Actions column.

Data Model Creation Details

Select at least one metric for each data model on the final step of data model creation. These selected metrics will be used for rendering in the mobile application. For example- tophits_0_x or count_x.

KPI Visualization

For KPI visualization, create a data model with numerical aggregation and no groupings in the last step.

Charts Visualization

The Data Model must be set as time-series data.


The data model must have one or more grouping fields selected.

💡Note: The “Select Metrics” section must not contain fields already selected under the “Select Grouping Fields” section

In the image above, ‘Select Grouping Fields’ has ‘asc_target’ and ‘asc_target_state,’ while ‘Select Metrics’ contains ‘count.’ Ensure these fields do not overlap to achieve the expected mobile visualization.

Import/Export Mobile Dashboards to JSON

You can Import or Export Mobile Dashboards using the ‘Import’ and ‘Export’ buttons.

Steps to Import / Export Mobile Dashboards

  1. Select the rows you want to export, then click the Export button.
  2.  A JSON file containing information about the selected rows will be downloaded.
  3. To add external rows, use the Import button to upload the JSON file.

💡Note: The Import will fail if the exported JSON file contains a mobile dashboard with the same name already present in the saved Mobile Dashboards.


The vuSmartMaps platform supports various visualizations such as KPIs, Tables, Charts, and Insights. For specific instructions on adding visualizations, visit the Adding Visualizations section.

To create a new Mobile Dashboard, go to the Mobile Dashboard Listing Page and click the “+” icon. This will take you to the Mobile Dashboard Configuration Page where you can enter the dashboard name, description, and add visualizations. For more details, see the Mobile Dashboard Configuration guide.

Ensure that your KPI visualization has a data model with numerical aggregation and no groupings. Any deviation from this can result in display issues. For more information, see the KPI Visualization section.

The data model for chart visualizations must be set as time-series data. If this requirement is not met, the visualization may not display correctly. Please review the Charts Visualization section for detailed guidelines.

The Mobile Dashboard listing page provides information about who created or last modified each dashboard, along with timestamps. For more details, visit the Mobile Dashboard Listing Page

To prevent import errors, make sure that the JSON file does not contain a mobile dashboard with the same name as any existing dashboards. For further details, see the Import/Export Mobile Dashboards to JSON section.


Browse through our resources to learn how you can accelerate digital transformation within your organisation.

Quick Links